Toolbartender MCP

🚀 ToolBartender 🍸

자연어 목표를 안전하고 구조화된 실행 계획(JSON)으로 변환하는 Planner MCP

ToolBartenderは、ユーザーの自然言語の要求を 1つのゴール として受け取り、 どのMCPツールをどの順序で呼び出すべきか の実行計画（plan）を生成する Planner MCP です。

実際のツール実行は行わず、LLM/実行エージェントが 安全かつ予測可能に 実行できるように、 steps / assumptions / required_confirmations / execution_hint を含むJSONを返します。

要約: ToolBartender = “ツール実行”ではなく、“ツールの組み合わせ計画”を作成するMCP

🚀 クイックスタート

1) ローカルでの実行

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python src/main.py
# ブラウザで http://localhost:3333/mcp を開く

2) Inspectorを使ったローカルテスト

npx @modelcontextprotocol/inspector
# http://localhost:6274

Inspector UIでサーバーURLを http://localhost:3333/mcp に接続します。

3) PlayMCPとの統合テスト

• パブリックURLが必要です（ngrok/デプロイ）
• PlayMCP → “新しいMCPサーバーの登録” → https:///mcp を入力 → 一時的に登録 → AIチャットに適用 この流れは既存のREADMEに記載されています。

✨ 主な機能

PoCエンドポイント

http://mcp.toolbartender.dev/mcp (Streamable HTTP / SSE)

キーワード

planner, safe execution, tool orchestration, PlayMCP

機能内容

次のような複合要求を1つのゴールとして受け取り、計画を生成します。

• 移動計画（例： “今日の午後8時に板橋から江南へ移動する”）
• 予定の照会/調整
• 情報の探索と要約
• 結果の伝達（メール/メッセンジャーなど）

出力される計画に含まれる内容

• steps: 使用するMCPツール + 実行順序
• assumptions: 前提条件
• required_confirmations: ユーザーの確認が必要な作業（特に書き込み系）
• execution_hint: 実行エージェント用のガイド

公開されているMCPツール（このサーバー）

PlayMCPの登録制限（正規表現）のため、ToolBartenderが公開するツール名はASCIIで固定することを推奨 します。

• plan_create : ゴール + 利用可能なツール → 計画の生成
• plan_validate: 計画が現在のコンテキスト（利用可能なツール）で実行可能かどうかを検証
• plan_render_prompt: LLM実行エージェントが steps を “順番に” 呼び出すようにプロンプトを生成
• plan_explain: ユーザーに計画を簡単に説明

内部の plan.steps[*].tool_name は他のMCPのツール名です（例： calendar.read, map.route）ので、そのままにするのが自然です。

ツールの入出力、スキーマ、例については docs/02_tools.md を参照してください。

📚 ドキュメント

• docs/00_quickstart.md : 5分でのセットアップ
• docs/01_concept.md : Planner MCPのコンセプト / 哲学 / ロードマップ
• docs/02_tools.md : ツールごとの入力/出力/例 + 命名規則
• docs/03_playmcp.md : PlayMCPへの登録ヒント / 審査の観点のチェックリスト
• docs/04_deploy.md : デプロイ（nginx/SSEを含む） + ドメイン/Cloudflareの設定
• docs/05_troubleshooting.md : 405/ハンドシェイク/SSE関連の問題のまとめ

📄 ライセンス

MIT