Cyberchef MCP

🚀 CyberChef MCP Server

このプロジェクトは、「サイバーの万能ナイフ」と呼ばれる CyberChef のための Model Context Protocol (MCP) サーバーインターフェースを提供します。

このサーバーを実行することで、ClaudeやCursor AIなどのAIアシスタントが、暗号化、エンコーディング、圧縮、フォレンジック分析など、300以上のデータ操作オペレーションを持つCyberChefの拡張ライブラリを実行可能なツールとしてネイティブに利用できるようになります。

🚀 クイックスタート

前提条件

• インストールされ、実行中の 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をデコードし、次にGunzipし、次にJSONを整形する」）に最適です。
• アトミックオペレーション: 特定のタスク用の300以上の個別ツールが、CyberChefの設定から動的に生成されます。
  • cyberchef_to_base64 / cyberchef_from_base64
  • cyberchef_aes_decrypt
  • cyberchef_sha2
  • cyberchef_yara_rules
  • ...その他何百ものツール。
• cyberchef_search: AIが利用可能なオペレーションとその説明を見つけるのに役立つユーティリティツール。

技術的なハイライト

• Docker化: Alpine Linuxベースの軽量で自己完結型のDockerコンテナとして実行されます。
• 標準入出力トランスポート: 標準入出力を介して通信するため、CLIベースのMCPクライアントとの統合が容易です。
• スキーマ検証: すべての入力は、zod を使用してCyberChefの内部型システムから派生したスキーマに対して検証されます。
• 最新のNode.js: Node.js v22+で実行するようにパッチが適用され、設定されています。

📚 ドキュメント

詳細なドキュメントは、 ディレクトリにあります。

• : 詳細なインストールとクライアントの設定。
• : 利用可能なすべての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ライセンス の下でリリースされており、Crown Copyright によって保護されています。