ToolBartender 🍸

Planner MCP that turns natural-language goals into safe, structured execution plans (JSON)

ToolBartender는 사용자의 자연어 요청을 하나의 goal로 받아,
어떤 MCP 도구를 어떤 순서로 호출해야 하는지 실행 계획(plan)을 생성하는 Planner MCP입니다.

실제 도구 실행은 하지 않고, LLM/실행 에이전트가 안전하고 예측 가능하게 실행하도록
steps / assumptions / required_confirmations / execution_hint를 포함한 JSON을 반환합니다.

한 줄 요약: ToolBartender = “도구 실행”이 아니라 “도구 조합 계획”을 만드는 MCP

PoC Endpoint

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

Keywords

planner, safe execution, tool orchestration, PlayMCP

What it does

다음과 같은 복합 요청을 하나의 goal로 받아 plan을 생성합니다.

• 이동 계획 (예: “오늘 오후 8시 판교에서 강남으로 이동”)
• 일정 조회/조정
• 정보 탐색 및 요약
• 결과 전달(이메일/메신저 등)

Output Plan includes

• steps: 사용할 MCP 도구 + 실행 순서
• assumptions: 전제 조건
• required_confirmations: 사용자 확인이 필요한 작업(특히 write 계열)
• execution_hint: 실행 에이전트용 가이드

Exposed MCP tools (this server)

PlayMCP 등록 제약(정규식) 때문에 ToolBartender가 노출하는 tool name은 ASCII로 고정을 권장합니다.

• plan_create : goal + available_tools → plan 생성
• plan_validate: plan이 현재 컨텍스트(available_tools)에서 실행 가능한지 검증
• plan_render_prompt: LLM 실행 에이전트가 steps를 “순서대로” 호출하도록 프롬프트 생성
• plan_explain: 사용자에게 plan을 쉽게 설명

내부 plan.steps[*].tool_name은 다른 MCP들의 도구 이름이므로 (예: calendar.read, map.route) 그대로 두는 구조가 자연스럽습니다.

도구 I/O, 스키마, 예시는 docs/02_tools.md 참고.

Quickstart

1) Local run

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

python src/main.py
# Open http://localhost:3333/mcp in your browser

2) Inspector로 로컬 테스트

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

Inspector UI에서 서버 URL을 http://localhost:3333/mcp로 연결합니다.

3) PlayMCP 통합 테스트

• public URL 필요(ngrok/배포)
• PlayMCP → “새로운 MCP 서버 등록” → https:///mcp 입력 → 임시 등록 → AI 채팅에 적용 흐름은 기존 README에 이미 있습니다.

Docs

• docs/00_quickstart.md : 5분 셋업
• docs/01_concept.md : Planner MCP 컨셉 / 철학 / 로드맵
• docs/02_tools.md : tool별 입력/출력/예시 + naming 규칙
• docs/03_playmcp.md : PlayMCP 등록 팁 / 심사 관점 체크리스트
• docs/04_deploy.md : 배포(nginx/SSE 포함) + 도메인/Cloudflare 포인트
• docs/05_troubleshooting.md : 405/핸드셰이크/SSE 관련 이슈 모음

License

MIT