Chepy MCP Service (CyberChef like Python library)

chepy-mcp

Chepy ライブラリ関数用 MCP サービス

概要

このプロジェクトでは、強力なデータ変換ライブラリである Chepy を MCP（Model Context Protocol） サーバーとして公開します。これにより、CyberChef に着想を得た、柔軟な単一の API である bake パイプラインツールを介して、エンコード、デコード、データ操作などの Chepy ツールを利用できます。

機能

• 単一のパイプラインツール（bake）：1 つ以上の Chepy 操作を、それぞれのパラメーターとともに 1 回のリクエストで連結できます
• Chepy レシピ JSON 形式：パイプラインは Chepy 独自のレシピシリアライズ形式で記述されるため、Chepy のインポート／エクスポートや CLI ツールと互換性があります
• リソースエンドポイント：利用可能なすべての Chepy 操作とそのシグネチャを確認できます
• 堅牢な検証のための unittest ベースのテストスイート

インストール

1. まだインストールされていない場合は、uv をインストールします。

   $ curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. リポジトリをクローンします：

   git clone https://github.com/nebucaz/chepy-mcp.git
   cd chepy-mcp
   

3. 依存関係をインストールします：

   uv sync
   

実行

次のコマンドでサーバーを実行します：

$ uv run src/server.py

使い方

Chepy レシピ JSON 形式

bake ツールは、Chepy レシピ JSON 形式のパイプラインを受け取ります：

{
  "input": "hello world",
  "recipe": [
    {"function": "to_base64", "args": {}},
    {"function": "from_base64", "args": {}}
  ]
}

• recipe リストの各ステップは、function（Chepy 操作名）と args（その関数の引数を格納する辞書）を持つオブジェクトです。
• この形式は、Chepy 独自のレシピのインポート／エクスポートや CLI ツールと完全に互換性があります。

応答では、出力がテキストかバイナリかが示されます：

{
  "type": "text",
  "data": "hello world"
}

利用可能な操作の確認

リソースエンドポイントを取得すると、利用可能なすべての Chepy 操作、そのパラメーターシグネチャ、および説明を確認できます：

• リソース URI： resource://chepy_operations

応答の例：

{
  "to_base64": {
    "signature": "(alphabet: str = 'standard')",
    "description": "Encode the input string to base64"
  },
  "from_base64": {
    "signature": "(alphabet: str = 'standard', remove_non_alpha: bool = True)",
    "description": "Decode base64 encoded string"
  }
}

拡張

• すべての Chepy 操作はパイプラインツールから利用できるため、個別のラッパーを追加する必要はありません。
• 必要に応じて、tests/ ディレクトリにテストを追加してください。

注意事項

• bake ツールは出力がテキストかバイナリかを自動的に判定し、バイナリは base64 にエンコードします。
• 有効な操作とそのパラメーターの一覧については、resource://chepy_operations リソースを参照してください。
• 柔軟性と保守性を最大限に高めるため、公開されるのは bake ツールと Chepy 操作のリソースのみです。
• パイプライン形式は、Chepy 独自のレシピシリアライズや CLI ツールと完全に互換性があります。

ライセンス

MIT

---