routy-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# 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` | 여행 삭제 |
+
+## 설치
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## 사용 방법
+
+### 1. API 키 발급
+
+[routy.co.kr](https://routy.co.kr) → 프로필 → API Keys 섹션에서 키를 생성하세요.
+
+### 2. Claude Desktop 설정
+
+`claude_desktop_config.json`에 추가:
+
+```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 함수에서 처리됩니다

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createClient } from "@supabase/supabase-js";
+import { createHash } from "node:crypto";
+// ── Config ───────────────────────────────────────────────────────
+const SUPABASE_URL = "https://cntscjgvayswahyadvxk.supabase.co";
+const SUPABASE_ANON_KEY = "sb_publishable_QpjCt3rQYues0CT2Q31fWw_g1y1y_Cb";
+let client;
+let keyHash;
+function initClient() {
+    const apiKey = process.env.ROUTY_API_KEY;
+    if (!apiKey) {
+        throw new Error("ROUTY_API_KEY is required.\n" +
+            "Generate one at https://routy.co.kr/profile → API Keys section.");
+    }
+    keyHash = createHash("sha256").update(apiKey).digest("hex");
+    client = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
+}
+// Helper: call RPC with key_hash
+async function rpc(fn, params = {}) {
+    const { data, error } = await client.rpc(fn, {
+        p_key_hash: keyHash,
+        ...params,
+    });
+    if (error)
+        throw new Error(error.message);
+    return data;
+}
+// ── MCP Server ───────────────────────────────────────────────────
+const server = new McpServer({
+    name: "routy",
+    version: "1.0.0",
+});
+// ── Tool: list_trips ─────────────────────────────────────────────
+server.tool("list_trips", "List my trips, or browse public trips.", {
+    public_only: z
+        .boolean()
+        .optional()
+        .describe("Only return public trips (default false = my trips)"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Max results (default 20)"),
+}, async ({ public_only, limit }) => {
+    try {
+        const data = await rpc("mcp_list_trips", {
+            p_public_only: public_only ?? false,
+            p_limit: limit ?? 20,
+        });
+        const trips = data ?? [];
+        if (trips.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: public_only
+                            ? "No public trips found."
+                            : "No trips yet. Use create_trip to make one!",
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(trips, null, 2) }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_trip ───────────────────────────────────────────────
+server.tool("get_trip", "Get full trip details including all days and places.", {
+    trip_id: z.string().uuid().describe("Trip ID"),
+}, async ({ trip_id }) => {
+    try {
+        const data = await rpc("mcp_get_trip", { p_trip_id: trip_id });
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: create_trip ────────────────────────────────────────────
+server.tool("create_trip", "Create a new trip with days. Returns the created trip ID.", {
+    name: z.string().min(1).describe("Trip name"),
+    start_date: z.string().describe("Start date (YYYY-MM-DD)"),
+    end_date: z.string().describe("End date (YYYY-MM-DD)"),
+    region: z
+        .enum(["DOMESTIC", "INTERNATIONAL"])
+        .optional()
+        .describe("Region type (default INTERNATIONAL)"),
+    memo: z.string().optional().describe("Trip description"),
+}, async ({ name, start_date, end_date, region, memo }) => {
+    try {
+        const data = await rpc("mcp_create_trip", {
+            p_name: name,
+            p_start_date: start_date,
+            p_end_date: end_date,
+            p_region: region ?? "INTERNATIONAL",
+            p_memo: memo ?? "",
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Trip created!\n  ID: ${data.trip_id}\n  Name: ${data.name}\n  Days: ${data.days}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: add_place ──────────────────────────────────────────────
+server.tool("add_place", "Add a place/POI to a specific day in a trip. Include google_place_id and place_url when available for rich marker info.", {
+    trip_id: z.string().uuid().describe("Trip ID"),
+    day_number: z.number().int().min(1).describe("Day number (1-based)"),
+    name: z.string().min(1).describe("Place name"),
+    lat: z.number().describe("Latitude"),
+    lng: z.number().describe("Longitude"),
+    address: z.string().optional().describe("Address"),
+    arrival_time: z
+        .string()
+        .optional()
+        .describe("Arrival time (HH:MM, default 09:00)"),
+    duration_minutes: z
+        .number()
+        .int()
+        .optional()
+        .describe("Stay duration in minutes (default 60)"),
+    memo: z.string().optional().describe("Note about this place"),
+    google_place_id: z
+        .string()
+        .optional()
+        .describe("Google Place ID (e.g. ChIJ...) — use for international places"),
+    kakao_place_id: z
+        .string()
+        .optional()
+        .describe("Kakao Place ID — use for domestic (Korean) places"),
+    place_url: z
+        .string()
+        .optional()
+        .describe("Google Maps URL for this place"),
+    category_name: z
+        .string()
+        .optional()
+        .describe("Place category (e.g. restaurant, temple)"),
+    phone: z.string().optional().describe("Phone number"),
+}, async ({ trip_id, day_number, name, lat, lng, address, arrival_time, duration_minutes, memo, google_place_id, kakao_place_id, place_url, category_name, phone }) => {
+    try {
+        const data = await rpc("mcp_add_place", {
+            p_trip_id: trip_id,
+            p_day_number: day_number,
+            p_name: name,
+            p_lat: lat,
+            p_lng: lng,
+            p_address: address ?? "",
+            p_arrival_time: arrival_time ?? "09:00",
+            p_duration_minutes: duration_minutes ?? 60,
+            p_memo: memo ?? "",
+            p_google_place_id: google_place_id ?? null,
+            p_kakao_place_id: kakao_place_id ?? null,
+            p_place_url: place_url ?? "",
+            p_category_name: category_name ?? "",
+            p_phone: phone ?? "",
+            p_is_in_route: true,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Place added to Day ${day_number}!\n  ID: ${data.place_id}\n  Name: ${data.name}\n  Order: ${data.order_index}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: update_trip ────────────────────────────────────────────
+server.tool("update_trip", "Update a trip's name, memo, or visibility (public/private).", {
+    trip_id: z.string().uuid().describe("Trip ID"),
+    name: z.string().optional().describe("New trip name"),
+    memo: z.string().optional().describe("New trip description"),
+    is_public: z
+        .boolean()
+        .optional()
+        .describe("Set true to make public, false for private"),
+}, async ({ trip_id, name, memo, is_public }) => {
+    try {
+        const data = await rpc("mcp_update_trip", {
+            p_trip_id: trip_id,
+            p_name: name ?? null,
+            p_memo: memo ?? null,
+            p_is_public: is_public ?? null,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Trip updated!\n${JSON.stringify(data, null, 2)}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: search_popular_places ──────────────────────────────────
+server.tool("search_popular_places", "Search globally popular places tracked across all Routy users.", {
+    query: z.string().min(1).describe("Search keyword (place name)"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Max results (default 10)"),
+}, async ({ query, limit }) => {
+    try {
+        const data = await rpc("mcp_search_places", {
+            p_query: query,
+            p_limit: limit ?? 10,
+        });
+        if (!data || data.length === 0) {
+            return {
+                content: [
+                    { type: "text", text: `No places found matching "${query}"` },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_rankings ───────────────────────────────────────────
+server.tool("get_rankings", "Get top-ranked public trips by views or likes.", {
+    sort_by: z
+        .enum(["views", "likes"])
+        .optional()
+        .describe("Sort by views or likes (default views)"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Max results (default 10)"),
+}, async ({ sort_by, limit }) => {
+    try {
+        const data = await rpc("mcp_get_rankings", {
+            p_sort_by: sort_by ?? "views",
+            p_limit: limit ?? 10,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: delete_trip ────────────────────────────────────────────
+server.tool("delete_trip", "Delete a trip and all its days/places (cascade).", {
+    trip_id: z.string().uuid().describe("Trip ID to delete"),
+}, async ({ trip_id }) => {
+    try {
+        const data = await rpc("mcp_delete_trip", { p_trip_id: trip_id });
+        return {
+            content: [{ type: "text", text: `Deleted trip: ${data.deleted}` }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Start ────────────────────────────────────────────────────────
+async function main() {
+    initClient();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "routy-mcp-server",
+  "version": "1.0.0",
+  "description": "Routy Travel Planner MCP Server — manage trips from any MCP client",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "routy-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@supabase/supabase-js": "^2.49.4",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  }
+}