Jotsu MCP

Jotsu MCP

Model Context Protocol（MCP）を実装し、MCP ツール、リソース、プロンプトを使用するワークフローを作成するための汎用ライブラリです。

クイックスタート

CLI を含むパッケージをインストールします。

pip install jotsu-mcp[cli]

空のワークフローを作成します。

jotsu-mcp workflow init

初期化コマンドを実行すると、現在のディレクトリにワークフローファイル workflow.json が作成されます。

実行します。

jotsu-mcp workflow run ./workflow.json

出力は、ワークフローの開始、単一ノードのメッセージ、ワークフローの終了という 3 つのメッセージで構成されます。 最終結果はワークフロー終了ノードの result フィールドに表示されます。この例では空のオブジェクトです。

MCP を試す

ワークフローから MCP サーバーのツールを呼び出せます。これにより、MCP にまだ対応していないモデル（実質的には Claude 以外のすべてのモデル）でも MCP を使用できます。

次のサーバーエントリーを追加します。

{
    "id": "hello",
    "name": "Hello World",
    "url": "https://hello.mcp.jotsu.com/mcp/"
}

注意：ID に使用できるのは、小文字、数字、:、_、- のみです。 注意：URL に /mcp/ のパスを忘れずに指定してください。

このサーバーは、リソースとツールをいくつか備えた、認証不要で公開されている MCP サーバーです。 （コードはこちらから入手できます。）

次に、サーバーのツール用ノードを追加します。

[
    {"id":  "greet", "type":  "tool", "name": "greet", "server_id":  "hello"}
]

greet ツールに必要な初期データを追加します。

{"name": "World"}

デフォルトでは、ワークフローは最初のノードから開始しますが、開始ノードを明示的に設定することもできます。

"start_node_id": "greet"

最後に、末尾に「generic」ノードを追加します。 generic ノードはアプリケーション固有です。つまり、ワークフローはデータを返すことでのみ処理します。 通常は、出力やデバッグに使用します。 タイプには、ワークフロー内でまだ使われていない任意の文字列を指定できます。この場合は「output」です。

{
    "id": "quickstart",
    "name": "quickstart",
    "description": "Simple workflow to interact with the 'hello' MCP server",
    "nodes": [
        {"id":  "greet", "type":  "tool", "name": "greet", "server_id":  "hello", "edges":  ["output"]},
        {"id":  "output", "type":  "output", "name": "The result"}
    ],
    "servers": [
        {
            "id": "hello",
            "name": "Hello World",
            "url": "https://hello.mcp.jotsu.com/mcp/"
        }
    ],
    "data": {"name":  "World"},
    "metadata": null
}

このワークフローをもう一度実行すると、さらに多くのデータが生成されますが、特に次のような行が含まれます。

{
  "action": "default",
  "timestamp": 132462.392532502,
  "id": "01k3h80zcaz050eg7080r3fnv7",
  "run_id": "01k3h80t6psmg0s5swsg4yke95",
  "node": {
    "id": "output",
    "name": "The result",
    "type": "output"
  },
  "data": {
    "name": "World",
    "greet": "Hello, World!"
  }
}

このノードのデータが、ワークフローの「result」として機能します。 ワークフローには複数の分岐を設定できるため、「result」は 1 つとは限りません。 ワークフローが実行したアクションによっては、このような行が複数出力されることがあります。

開発

uv venv
uv pip install '.[dev,cli,anthropic,openai,cloudflare,cryptography]'