@dodo-planet/mcp

Dodo Planet 가족 여행 데이터를 Model Context Protocol로 노출하는 stdio 서버. Claude Code, Cursor, Codex, Cline 등 MCP 호환 코딩 에이전트에서 자연어로 호출 가능.

사전 작업

먼저 @dodo-planet/cli로 PAT 등록(또는 DODO_TOKEN 환경변수 설정).

Claude Code

claude mcp add dodo -- npx -y @dodo-planet/mcp

또는 ~/.config/dodo/credentials.json을 못 읽는 sandboxed 환경에서:

claude mcp add dodo --env DODO_TOKEN=dodo_pat_xxx -- npx -y @dodo-planet/mcp

Cursor / Cline

mcpServers 설정에 추가:

{
  "mcpServers": {
    "dodo": {
      "command": "npx",
      "args": ["-y", "@dodo-planet/mcp"],
      "env": {
        "DODO_TOKEN": "dodo_pat_xxx"
      }
    }
  }
}

Codex

codex mcp add dodo --command "npx -y @dodo-planet/mcp" --env DODO_TOKEN=dodo_pat_xxx

환경변수

• DODO_TOKEN — PAT (CLI credentials 파일 무시)
• DODO_API_URL — API 엔드포인트 (기본 https://www.dodoplanet.space)
• DODO_CONFIG_HOME — 설정 디렉토리 (CLI와 공유)

노출되는 도구

43개 도메인 함수 — 여행 관리, 경비, 예약, 일정, 피드, 아이 정보, 항공·호텔·액티비티·교통편 검색, 장소·날씨·경로, 가족·친구·초대, 웹 검색.

전체 목록과 인자 스키마는 MCP 클라이언트의 도구 검색 UI에서 확인.

보안 표시:

• readOnlyHint: true — 읽기 전용 (예: list/get/search)
• destructiveHint: true — 데이터 삭제 (예: delete_, remove_)
• idempotentHint: true — 동일 호출이 동일 결과 (read-only와 같음)
• openWorldHint: true — 외부 정보 (Amadeus, Google Maps, Perplexity, OpenWeather)

동작 방식

[Claude Code/Cursor]
        ↓ MCP stdio
[@dodo-planet/mcp]
        ↓ HTTPS Bearer
[https://www.dodoplanet.space/api/cli/{declarations,execute}]
        ↓ Service Role
[Supabase + Gemini executeFunction]

CLI와 MCP는 동일한 /api/cli/* 엔드포인트를 공유. 시크릿(SUPABASE_SERVICE_ROLE_KEY, Amadeus·Perplexity 키)은 절대 사용자 머신으로 새지 않음.