TransformerBee.MCP

TransformerBee.MCP

これは、Python で書かれた transformer.bee 用のシンプルな Model Context Protocol（MCP）サーバーの PoC です。 内部では、python-mcp と transformerbeeclient.py を使用しています。

インストール

MCP サーバーは Python パッケージとしてインストールするか、Docker イメージをプルできます。

Python パッケージとしてインストール

uv install transformerbeemcp

または、pip を使用している場合：

pip install transformerbeemcp

Docker イメージとしてインストール

docker pull ghcr.io/hochfrequenz/transformerbee.mcp:latest

CLI からサーバーを起動する

Python

_このパッケージには、サーバーを起動するためのシンプルな CLI 引数が用意されています。 パッケージをインストールした仮想環境（ここでは myvenv）内のターミナルで、次のコマンドを実行します：

(myvenv) run-transformerbee-mcp-server

Docker

docker run --network host -i --rm -e TRANSFORMERBEE_HOST=http://localhost:5021 ghcr.io/hochfrequenz/transformerbee.mcp:latest

（環境変数 -e ... については、以下または transformerbeeclient.py のドキュメントを参照してください。）

Claude Desktop に MCP サーバーを登録する

このリポジトリをチェックアウトした場合

cd path/to/reporoot/src/transformerbeemcp
fastmcp install server.py

pip/uv でパッケージをインストールした場合

claude_desktop_config.json を編集します（Claude Desktop のメニューから「Datei > Einstellungen > Entwickler > Konfiguration bearbeiten」を選択すると見つかります）。

{
  "mcpServers": {
    "TransformerBee.mcp": {
      "command": "C:\\github\\MyProject\\.myvenv\\Scripts\\run-transformerbee-mcp-server.exe",
      "args": [],
      "env": {
        "TRANSFORMERBEE_HOST": "http://localhost:5021",
        "TRANSFORMERBEE_CLIENT_ID": "",
        "TRANSFORMERBEE_CLIENT_SECRET": ""
      }
    }
  }
}

ここで、C:\github\MyProject\.myvenv はパッケージをインストールした仮想環境へのパスで、localhost:5021 は Docker コンテナーで実行されている transformer.bee を公開します。 また、この便利な CLI コマンドを設定していない場合は、 https://github.com/Hochfrequenz/TransformerBee.mcp/blob/c0898769670469df13f23b57a55fe4b71ed9795b/pyproject.toml#L101-L102

空ではない引数を指定して Python を呼び出すだけでも構いません。

多くの MCP ツールは uv がインストールされていることを前提としているため、仮想環境にもインストールが必要になる場合があります。

環境変数や transformer.bee のローカルでの起動方法については、transformerbeeclient.py のドキュメントを確認してください。

Docker でパッケージをインストールした場合

{
  "mcpServers": {
    "TransformerBee.mcp": {
      "command": "docker",
      "args": [
        "run",
        "--network",
        "host",
        "-i",
        "--rm",
        "-e",
        "TRANSFORMERBEE_HOST=http://localhost:5021",
        "ghcr.io/hochfrequenz/transformerbee.mcp:latest"
      ],
      "env": {
        "TRANSFORMERBEE_HOST": "http://localhost:5021",
        "TRANSFORMERBEE_CLIENT_ID": "",
        "TRANSFORMERBEE_CLIENT_SECRET": ""
      }
    }
  }
}

--network host オプションを使うのは少し裏技的で、ベストプラクティスではないことは承知しています。