Cyberchef MCP

🚀 CyberChef MCP 服务器

本项目为被誉为“网络瑞士军刀”的 CyberChef 提供了一个 模型上下文协议（Model Context Protocol，MCP） 服务器接口。借助此服务器，AI 助手（如 Claude、Cursor AI 等）能够直接调用 CyberChef 丰富的 300 多种数据处理操作库，涵盖加密、编码、压缩和法医分析等功能，将这些操作作为可执行工具使用。

🚀 快速开始

前提条件

• 已安装并运行 Docker。

安装与使用

1. 构建 Docker 镜像：

docker build -f Dockerfile.mcp -t cyberchef-mcp .

2. 运行服务器（交互模式）： 此命令将启动服务器并监听标准输入，这也是你的 MCP 客户端将执行的操作。

docker run -i --rm cyberchef-mcp

✨ 主要特性

MCP 工具

服务器将 CyberChef 操作以 MCP 工具的形式对外暴露：

• cyberchef_bake：“万能工具”。可对输入数据执行完整的 CyberChef 配方（一系列操作），非常适合复杂的多步骤转换，例如“先对 Base64 进行解码，再进行解压缩，最后美化 JSON 格式”。
• 原子操作：超过 300 个针对特定任务的独立工具，这些工具是根据 CyberChef 配置动态生成的。
  • cyberchef_to_base64 / cyberchef_from_base64
  • cyberchef_aes_decrypt
  • cyberchef_sha2
  • cyberchef_yara_rules
  • ... 还有数百个其他工具。
• cyberchef_search：一个实用工具，可帮助 AI 发现可用的操作及其描述。

技术亮点

• 容器化：基于 Alpine Linux 以轻量级、自包含的 Docker 容器形式运行。
• 标准输入输出传输：通过标准输入输出进行通信，便于与基于命令行界面（CLI）的 MCP 客户端集成。
• 模式验证：所有输入都使用 zod 根据从 CyberChef 内部类型系统派生的模式进行验证。
• 现代 Node.js：经过修补和配置，可在 Node.js v22+ 上运行。

📦 安装指南

客户端配置

Cursor AI

1. 转到 设置 > 功能 > MCP。
2. 添加新服务器：
   • 名称：CyberChef
   • 类型：command
   • 命令：docker
   • 参数：run -i --rm cyberchef-mcp

Claude Code（CLI）

在你的配置文件中添加以下内容：

{
  "mcpServers": {
    "cyberchef": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "cyberchef-mcp"]
    }
  }
}

📚 详细文档

详细文档可在 目录中找到：

• ：详细的安装和客户端配置说明。
• ：所有可用的 MCP 工具和操作列表。
• ：MCP 服务器的技术设计。

🔧 技术细节

本地设置

如果你想在不使用 Docker 的情况下修改服务器代码，可以按照以下步骤操作：

1. 安装依赖：

npm install

2. 生成配置：（构建内部操作列表时需要）

npx grunt configTests

3. 运行服务器：

npm run mcp

持续集成/持续部署（CI/CD）

本项目使用 GitHub Actions 确保稳定性：

• 核心 CI：在 Node.js v22 上测试底层 CyberChef 逻辑和配置生成。
• Docker 构建：每次推送代码时构建并验证 cyberchef-mcp Docker 镜像。
• 发布：在版本标签（v*）时自动将 Docker 镜像发布到 GHCR。

🤝 贡献代码

欢迎对 MCP 适配器进行贡献！请参考 to-dos/ 目录了解计划中的功能和任务。

如果要对核心 CyberChef 操作进行贡献，请注明原始的 GCHQ 仓库。

📄 许可证

CyberChef 采用 Apache 2.0 许可证 发布，并受 皇家版权 保护。