@dodo-planet/mcp 0.1.4

package/README.md

@@ -0,0 +1,75 @@
+# @dodo-planet/mcp
+
+Dodo Planet 가족 여행 데이터를 [Model Context Protocol](https://modelcontextprotocol.io)로 노출하는 stdio 서버. Claude Code, Cursor, Codex, Cline 등 MCP 호환 코딩 에이전트에서 자연어로 호출 가능.
+
+## 사전 작업
+
+먼저 [@dodo-planet/cli](https://www.npmjs.com/package/@dodo-planet/cli)로 PAT 등록(또는 `DODO_TOKEN` 환경변수 설정).
+
+## Claude Code
+
+```bash
+claude mcp add dodo -- npx -y @dodo-planet/mcp
+```
+
+또는 `~/.config/dodo/credentials.json`을 못 읽는 sandboxed 환경에서:
+
+```bash
+claude mcp add dodo --env DODO_TOKEN=dodo_pat_xxx -- npx -y @dodo-planet/mcp
+```
+
+## Cursor / Cline
+
+`mcpServers` 설정에 추가:
+
+```json
+{
+  "mcpServers": {
+    "dodo": {
+      "command": "npx",
+      "args": ["-y", "@dodo-planet/mcp"],
+      "env": {
+        "DODO_TOKEN": "dodo_pat_xxx"
+      }
+    }
+  }
+}
+```
+
+## Codex
+
+```bash
+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 키)은 절대 사용자 머신으로 새지 않음.

package/bin/dodo-mcp.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import("../dist/index.js").then((mod) => mod.run()).catch((err) => {
+  process.stderr.write((err?.stack || err?.message || String(err)) + "\n");
+  process.exit(1);
+});

package/dist/index.js

@@ -0,0 +1,342 @@
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z as z2 } from "zod";
+
+// src/zod-from-jsonschema.ts
+import { z } from "zod";
+function zodFromJsonSchema(schema) {
+  if (!schema) return z.unknown();
+  const variants = schema.anyOf ?? schema.oneOf;
+  if (variants && variants.length > 0) {
+    const nullVariant = variants.find((v) => v.type === "null");
+    const nonNullVariants = variants.filter((v) => v.type !== "null");
+    if (nonNullVariants.length === 1) {
+      const inner = zodFromJsonSchema(nonNullVariants[0]);
+      return nullVariant ? inner.nullable() : inner;
+    }
+    if (nonNullVariants.length > 1) {
+      const unioned = z.union(
+        nonNullVariants.map((v) => zodFromJsonSchema(v))
+      );
+      return nullVariant ? unioned.nullable() : unioned;
+    }
+  }
+  if (!schema.type) return z.unknown();
+  const wrapNullable = (s) => schema.nullable ? s.nullable() : s;
+  switch (schema.type) {
+    case "null":
+      return z.null();
+    case "string": {
+      let s = schema.enum && schema.enum.length > 0 ? z.enum(schema.enum) : z.string();
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    case "integer": {
+      let s = z.number().int();
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    case "number": {
+      let s = z.number();
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    case "boolean": {
+      let s = z.boolean();
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    case "array": {
+      const inner = zodFromJsonSchema(schema.items);
+      let s = z.array(inner);
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    case "object": {
+      const props = schema.properties ?? {};
+      const required = new Set(schema.required ?? []);
+      const shape = {};
+      for (const [key, child] of Object.entries(props)) {
+        let v = zodFromJsonSchema(child);
+        if (!required.has(key)) v = v.optional();
+        shape[key] = v;
+      }
+      let s = z.object(shape);
+      if (schema.description) s = s.describe(schema.description);
+      return wrapNullable(s);
+    }
+    default:
+      return z.unknown();
+  }
+}
+function zodShapeFromJsonSchema(schema) {
+  if (!schema || schema.type !== "object" || !schema.properties) return {};
+  const required = new Set(schema.required ?? []);
+  const shape = {};
+  for (const [key, child] of Object.entries(schema.properties)) {
+    let v = zodFromJsonSchema(child);
+    if (!required.has(key)) v = v.optional();
+    shape[key] = v;
+  }
+  return shape;
+}
+
+// src/credentials.ts
+import { readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function getConfigDir() {
+  const override = process.env.DODO_CONFIG_HOME;
+  if (override) return override;
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) return join(xdg, "dodo");
+  return join(homedir(), ".config", "dodo");
+}
+function getCredentialsPath() {
+  return join(getConfigDir(), "credentials.json");
+}
+function loadToken() {
+  const fromEnv = process.env.DODO_TOKEN;
+  if (fromEnv && fromEnv.trim()) return fromEnv.trim();
+  const path = getCredentialsPath();
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed.token || null;
+  } catch {
+    return null;
+  }
+}
+function loadApiUrl() {
+  if (process.env.DODO_API_URL) return process.env.DODO_API_URL.trim();
+  const cfgPath = join(getConfigDir(), "config.json");
+  if (existsSync(cfgPath)) {
+    try {
+      const cfg = JSON.parse(readFileSync(cfgPath, "utf8"));
+      if (cfg.apiUrl) return cfg.apiUrl;
+    } catch {
+    }
+  }
+  return "https://www.dodoplanet.space";
+}
+function loadActiveTripId() {
+  if (process.env.DODO_TRIP_ID) return process.env.DODO_TRIP_ID.trim() || void 0;
+  const statePath = join(getConfigDir(), "state.json");
+  if (!existsSync(statePath)) return void 0;
+  try {
+    const state = JSON.parse(readFileSync(statePath, "utf8"));
+    return state.activeTrip?.id;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/function-catalog-shared.ts
+var FUNCTION_CATALOG = [
+  // ── 외부 검색 / 정보 조회 (read-only, 11개)
+  { name: "get_weather", category: "weather", verb: "show", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "get_flight_status", category: "flight", verb: "status", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "search_nearby_places", category: "place", verb: "search", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "search_places_text", category: "place", verb: "search-text", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "get_place_details", category: "place", verb: "details", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "get_directions", category: "directions", verb: "show", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "search_flights", category: "flight", verb: "search", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "search_hotels", category: "hotel", verb: "search", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "search_transfers", category: "transfer", verb: "search", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "search_activities", category: "activity", verb: "search", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "search_web_perplexity", category: "web", verb: "search", requiresTrip: false, isWrite: false, isDestructive: false },
+  // ── Trip 관리 (4개)
+  { name: "list_trips", category: "trip", verb: "list", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "get_current_trip", category: "trip", verb: "current", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "switch_trip", category: "trip", verb: "switch", requiresTrip: false, isWrite: true, isDestructive: false },
+  { name: "create_trip", category: "trip", verb: "create", requiresTrip: false, isWrite: true, isDestructive: false },
+  // ── 경비 (4개)
+  { name: "get_expenses", category: "expense", verb: "list", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "add_expense", category: "expense", verb: "add", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "update_expense", category: "expense", verb: "update", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "delete_expense", category: "expense", verb: "delete", requiresTrip: true, isWrite: true, isDestructive: true },
+  // ── 예약 (4개)
+  { name: "get_bookings", category: "booking", verb: "list", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "add_booking", category: "booking", verb: "add", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "update_booking", category: "booking", verb: "update", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "delete_booking", category: "booking", verb: "delete", requiresTrip: true, isWrite: true, isDestructive: true },
+  // ── 일정 (4개)
+  { name: "get_itinerary", category: "itinerary", verb: "show", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "add_place_to_itinerary", category: "itinerary", verb: "add", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "remove_place_from_itinerary", category: "itinerary", verb: "remove", requiresTrip: true, isWrite: true, isDestructive: true },
+  { name: "reorder_itinerary", category: "itinerary", verb: "reorder", requiresTrip: true, isWrite: true, isDestructive: false },
+  // ── 피드 (3개)
+  { name: "get_feed", category: "feed", verb: "list", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "add_feed_post", category: "feed", verb: "post", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "delete_feed_post", category: "feed", verb: "delete", requiresTrip: true, isWrite: true, isDestructive: true },
+  // ── 아이 정보 (7개)
+  { name: "list_babies", category: "baby", verb: "list", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "get_baby_info", category: "baby", verb: "info", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "add_baby", category: "baby", verb: "add", requiresTrip: false, isWrite: true, isDestructive: false },
+  { name: "update_baby_info", category: "baby", verb: "update", requiresTrip: false, isWrite: true, isDestructive: false },
+  { name: "update_baby_status", category: "baby", verb: "status", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "add_baby_travel_note", category: "baby", verb: "note", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "delete_baby", category: "baby", verb: "delete", requiresTrip: false, isWrite: true, isDestructive: true },
+  // ── 가족 / 친구 / 초대 (6개)
+  { name: "get_family_members", category: "family", verb: "list", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "add_family_to_trip", category: "family", verb: "add-to-trip", requiresTrip: true, isWrite: true, isDestructive: false },
+  { name: "get_friends", category: "friend", verb: "list", requiresTrip: false, isWrite: false, isDestructive: false },
+  { name: "add_friend", category: "friend", verb: "add", requiresTrip: false, isWrite: true, isDestructive: false },
+  { name: "get_invitations", category: "invite", verb: "list", requiresTrip: true, isWrite: false, isDestructive: false },
+  { name: "invite_to_trip", category: "invite", verb: "create", requiresTrip: true, isWrite: true, isDestructive: false }
+];
+var CATALOG_BY_NAME = new Map(
+  FUNCTION_CATALOG.map((meta) => [meta.name, meta])
+);
+function getFunctionMeta(name) {
+  return CATALOG_BY_NAME.get(name);
+}
+
+// src/index.ts
+async function fetchDeclarations(apiUrl) {
+  const url = new URL("/api/cli/declarations", apiUrl);
+  url.searchParams.set("hasTrip", "true");
+  const response = await fetch(url.toString());
+  if (!response.ok) {
+    throw new Error(`Failed to fetch declarations: HTTP ${response.status}`);
+  }
+  const json = await response.json();
+  return json.declarations ?? [];
+}
+async function executeOnServer(apiUrl, token, name, args, options = {}) {
+  const headers = {
+    authorization: `Bearer ${token}`,
+    "content-type": "application/json"
+  };
+  if (options.confirmDestructive) headers["x-dodo-confirm"] = "yes";
+  const response = await fetch(new URL("/api/cli/execute", apiUrl).toString(), {
+    method: "POST",
+    headers,
+    body: JSON.stringify({ name, args, tripId: options.tripId })
+  });
+  const text = await response.text();
+  let parsed = text;
+  try {
+    parsed = text ? JSON.parse(text) : null;
+  } catch {
+  }
+  if (!response.ok) {
+    const msg = parsed && typeof parsed === "object" && "error" in parsed ? String(parsed.error) : `HTTP ${response.status}`;
+    throw new Error(msg);
+  }
+  return parsed;
+}
+function humanizeResult(result) {
+  if (typeof result === "string") return result;
+  if (typeof result !== "object" || result === null) return JSON.stringify(result);
+  const r = result;
+  if (typeof r.message === "string") return r.message;
+  if (r.data !== void 0) return JSON.stringify(r.data, null, 2);
+  return JSON.stringify(result, null, 2);
+}
+async function run() {
+  const token = loadToken();
+  const apiUrl = loadApiUrl();
+  const ambientTripId = loadActiveTripId();
+  if (!token) {
+    process.stderr.write(
+      "Error: dodo PAT\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\n  - \uC6F9 \uC124\uC815 \u2192 \uAC1C\uBC1C\uC790 \uD1A0\uD070 \uC5D0\uC11C \uBC1C\uAE09 \uD6C4\n  - CLI: `dodo auth login` \uC2E4\uD589 (~/.config/dodo/credentials.json \uC800\uC7A5)\n  - \uB610\uB294 \uD658\uACBD\uBCC0\uC218 DODO_TOKEN \uC124\uC815\n"
+    );
+    process.exit(2);
+  }
+  let declarations;
+  try {
+    declarations = await fetchDeclarations(apiUrl);
+  } catch (err) {
+    process.stderr.write(`Error: declarations fetch \uC2E4\uD328: ${err instanceof Error ? err.message : err}
+`);
+    process.exit(3);
+  }
+  const server = new McpServer({
+    name: "dodo-planet",
+    version: "0.1.0"
+  });
+  for (const decl of declarations) {
+    const meta = getFunctionMeta(decl.name) ?? decl.meta;
+    if (!meta) continue;
+    const inputSchema = zodShapeFromJsonSchema(decl.parametersJsonSchema);
+    if (meta.isDestructive) {
+      inputSchema.confirm = z2.literal(true).describe("\uC774 \uC791\uC5C5\uC740 \uC601\uAD6C \uC0AD\uC81C\uC774\uBBC0\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC758\uB3C4\uD55C \uACBD\uC6B0\uC5D0\uB9CC confirm: true \uB85C \uD638\uCD9C\uD558\uC138\uC694.");
+    }
+    if (meta.requiresTrip) {
+      inputSchema.tripId = z2.string().optional().describe(
+        "Trip UUID. \uBBF8\uC9C0\uC815 \uC2DC \uC0AC\uC6A9\uC790\uAC00 \uB9C8\uC9C0\uB9C9\uC73C\uB85C dodo trip switch \uD55C \uD65C\uC131 trip \uB610\uB294 DODO_TRIP_ID \uD658\uACBD\uBCC0\uC218 \uAC12\uC744 \uC0AC\uC6A9."
+      );
+    }
+    const description = meta.isDestructive ? `${decl.description}
+
+\u26A0\uFE0F DESTRUCTIVE: \uC774 \uB3C4\uAD6C\uB294 \uC601\uAD6C \uC0AD\uC81C\uB97C \uC218\uD589\uD569\uB2C8\uB2E4. \uD638\uCD9C \uC2DC args.confirm = true \uAC00 \uD544\uC694\uD558\uBA70, \uD638\uC2A4\uD2B8 \uC0AC\uC6A9\uC790\uC758 \uBA85\uC2DC \uB3D9\uC758\uAC00 \uC788\uC744 \uB54C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.` : decl.description;
+    server.registerTool(
+      decl.name,
+      {
+        title: decl.name,
+        description,
+        inputSchema,
+        annotations: {
+          readOnlyHint: !meta.isWrite,
+          destructiveHint: meta.isDestructive,
+          idempotentHint: !meta.isWrite,
+          openWorldHint: meta.category === "place" || meta.category === "weather" || meta.category === "web" || meta.category === "directions" || meta.category === "flight" || meta.category === "hotel" || meta.category === "activity" || meta.category === "transfer"
+        }
+      },
+      async (args) => {
+        try {
+          const confirmDestructive = meta.isDestructive && args?.confirm === true;
+          if (meta.isDestructive && !confirmDestructive) {
+            return {
+              content: [{ type: "text", text: "Error: destructive \uB3C4\uAD6C\uB294 args.confirm = true \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." }],
+              isError: true
+            };
+          }
+          const passArgs = { ...args ?? {} };
+          delete passArgs.confirm;
+          const argTripId = args?.tripId;
+          delete passArgs.tripId;
+          const tripId = meta.requiresTrip ? typeof argTripId === "string" ? argTripId : ambientTripId : void 0;
+          if (meta.requiresTrip && !tripId) {
+            return {
+              content: [{
+                type: "text",
+                text: "Error: \uD65C\uC131 trip\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uD638\uC2A4\uD2B8 \uC178\uC5D0\uC11C `dodo trip switch <name>` \uC73C\uB85C \uD65C\uC131 trip\uC744 \uC9C0\uC815\uD558\uAC70\uB098, DODO_TRIP_ID \uD658\uACBD\uBCC0\uC218 \uB610\uB294 tool args\uC758 tripId\uB97C \uC0AC\uC6A9\uD558\uC138\uC694."
+              }],
+              isError: true
+            };
+          }
+          const result = await executeOnServer(apiUrl, token, decl.name, passArgs, { confirmDestructive, tripId });
+          const text = humanizeResult(result);
+          return {
+            content: [{ type: "text", text }],
+            structuredContent: typeof result === "object" && result !== null ? result : { value: result }
+          };
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          return {
+            content: [{ type: "text", text: `Error: ${msg}` }],
+            isError: true
+          };
+        }
+      }
+    );
+  }
+  const serverNames = new Set(declarations.map((d) => d.name));
+  const localNames = new Set(FUNCTION_CATALOG.map((m) => m.name));
+  const missingInServer = [...localNames].filter((n) => !serverNames.has(n));
+  if (missingInServer.length > 0) {
+    process.stderr.write(
+      `Warning: \uC11C\uBC84 declaration\uC5D0 \uB204\uB77D\uB41C \uD568\uC218 ${missingInServer.length}\uAC1C. \uC11C\uBC84 \uBC30\uD3EC\uAC00 \uBBF8\uB7EC\uBCF4\uB2E4 \uC624\uB798\uB418\uC5C8\uC744 \uC218 \uC788\uC74C.
+`
+    );
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+export {
+  run
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@dodo-planet/mcp",
+  "version": "0.1.4",
+  "description": "Dodo Planet MCP server — exposes 43 family-trip functions to Claude Code, Cursor, Codex via stdio.",
+  "type": "module",
+  "bin": {
+    "dodo-mcp": "./bin/dodo-mcp.mjs"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Engccer/dodo-planet.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/Engccer/dodo-planet/tree/main/packages/mcp#readme",
+  "bugs": "https://github.com/Engccer/dodo-planet/issues",
+  "license": "MIT",
+  "keywords": [
+    "dodo-planet",
+    "mcp",
+    "claude-code",
+    "model-context-protocol"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}