Toolbartender MCP

🚀 ToolBartender 🍸

ToolBartender는 사용자의 자연어 요청을 하나의 목표(goal)로 받아, 어떤 MCP 도구를 어떤 순서로 호출해야 하는지 실행 계획(plan)을 생성하는 Planner MCP입니다. 이는 실제 도구 실행을 하지 않고, LLM/실행 에이전트가 안전하고 예측 가능하게 실행하도록 steps / assumptions / required_confirmations / execution_hint를 포함한 JSON을 반환합니다.

🚀 快速開始

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 中說明。

✨ 主要特性

• 目標處理：能夠將各種複合請求作為一個目標接收並生成執行計劃，如移動計劃、日程查詢/調整、信息探索和總結、結果傳遞等。
• 安全執行：不執行實際工具，而是為 LLM/執行代理提供安全且可預測的執行計劃，以 JSON 格式返回。
• 工具編排：生成的計劃包含使用的 MCP 工具和執行順序，以及前提條件、用戶確認需求和執行提示。

📦 安裝指南

本地環境搭建

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

啟動服務

python src/main.py

💻 使用示例

基礎用法

通過向 PoC 端點發送請求來獲取執行計劃：

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

📚 詳細文檔

• 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 相關問題彙總。

🔧 技術細節

輸出計劃包含內容

• steps：要使用的 MCP 工具以及執行順序。
• assumptions：前提條件。
• required_confirmations：需要用戶確認的操作（特別是寫入類操作）。
• execution_hint：為執行代理提供的指南。

暴露的 MCP 工具

由於 PlayMCP 註冊限制（正則表達式），建議 ToolBartender 暴露的工具名稱固定為 ASCII 格式。

• plan_create：根據目標和可用工具生成計劃。
• plan_validate：驗證計劃在當前上下文（可用工具）中是否可執行。
• plan_render_prompt：為 LLM 執行代理生成按順序調用步驟的提示。
• plan_explain：向用戶簡單解釋計劃。

工具的輸入/輸出、架構和示例請參考 docs/02_tools.md。

📄 許可證

本項目採用 MIT 許可證。