Routy MCP Server

Routy 여행 플래너의 MCP (Model Context Protocol) 서버입니다. Claude Desktop, Cursor 등 MCP 클라이언트에서 본인 Routy 계정으로 여행을 조회/생성/관리할 수 있습니다.

제공 도구 (Tools)

| 도구 | 설명 | |------|------| | list_trips | 내 여행 목록 / 공개 여행 조회 | | get_trip | 여행 상세 조회 (일정+장소 포함) | | create_trip | 새 여행 생성 | | add_place | 일정에 장소 추가 | | search_popular_places | 인기 장소 검색 | | get_rankings | 인기 여행 순위 (조회수/좋아요) | | delete_trip | 여행 삭제 |

설치

cd mcp-server
npm install
npm run build

사용 방법

1. API 키 발급

routy.co.kr → 프로필 → API Keys 섹션에서 키를 생성하세요.

2. Claude Desktop 설정

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "routy": {
      "command": "node",
      "args": ["/path/to/routy/mcp-server/dist/index.js"],
      "env": {
        "ROUTY_API_KEY": "routy_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. 사용

Claude Desktop에서 자연어로:

• "내 여행 목록 보여줘" → list_trips
• "도쿄 3박 4일 여행 만들어줘" → create_trip + add_place
• "인기 여행 순위 알려줘" → get_rankings
• "신주쿠 인기 장소 검색해줘" → search_popular_places

보안

• API 키는 SHA-256 해싱되어 저장됩니다
• 키가 유출되면 프로필에서 즉시 폐기하고 새로 발급하세요
• 서버는 Supabase anon key만 사용하며, 모든 인증은 서버사이드 RPC 함수에서 처리됩니다