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 许可证。