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 許可證 發佈，並受 皇家版權 保護。