gencow 0.1.0

package/bin/gencow-mcp.mjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+/**
+ * packages/cli/bin/gencow-mcp.mjs
+ *
+ * Gencow MCP Server — AI 에이전트가 Gencow API를 자동 조회·호출할 수 있도록
+ * MCP (Model Context Protocol) 서버를 stdio 전송으로 제공합니다.
+ *
+ * Resources:
+ *   - gencow://openapi-spec   → OpenAPI 3.0 JSON
+ *   - gencow://api-list       → 등록된 API 경로 목록
+ *
+ * Tools:
+ *   - list_apis        → 등록된 query/mutation 목록
+ *   - call_query       → query 호출
+ *   - call_mutation    → mutation 호출
+ *   - get_openapi_spec → OpenAPI 스펙 조회
+ *
+ * Usage:
+ *   gencow mcp                              (기본 포트 5456)
+ *   gencow mcp --port 3000                  (커스텀 포트)
+ *   GENCOW_PORT=3000 gencow mcp             (환경변수)
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+    ListToolsRequestSchema,
+    CallToolRequestSchema,
+    ListResourcesRequestSchema,
+    ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const BASE_URL = `http://localhost:${process.env.GENCOW_PORT || 5456}`;
+
+// ─── Helpers ────────────────────────────────────────────
+
+async function fetchJSON(path) {
+    const res = await fetch(`${BASE_URL}${path}`);
+    if (!res.ok) throw new Error(`Gencow API error: ${res.status} ${await res.text()}`);
+    return res.json();
+}
+
+async function postJSON(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    return { status: res.status, data };
+}
+
+// ─── MCP Server ─────────────────────────────────────────
+
+const server = new Server(
+    { name: "gencow", version: "0.1.0" },
+    {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    }
+);
+
+// ── Tools ───────────────────────────────────────────────
+
+const TOOLS = [
+    {
+        name: "list_apis",
+        description: "등록된 전체 API 목록을 조회합니다. 각 API의 이름, 경로, 타입(query/mutation), 지원 HTTP 메서드를 반환합니다.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "call_query",
+        description: "Gencow query를 호출합니다. 예: name='tasks.list', args={}. 경로: POST /api/fn/{module}/{name}",
+        inputSchema: {
+            type: "object",
+            required: ["name"],
+            properties: {
+                name: { type: "string", description: "Query name (dot notation), e.g. 'tasks.list', 'tasks.get', 'files.list'" },
+                args: { type: "object", description: "Query arguments as JSON object", additionalProperties: true },
+            },
+        },
+    },
+    {
+        name: "call_mutation",
+        description: "Gencow mutation을 호출합니다. 예: name='tasks.create', args={ title: '새 태스크' }. 경로: POST /api/fn/{module}/{name}",
+        inputSchema: {
+            type: "object",
+            required: ["name"],
+            properties: {
+                name: { type: "string", description: "Mutation name (dot notation), e.g. 'tasks.create', 'tasks.update', 'tasks.delete'" },
+                args: { type: "object", description: "Mutation arguments as JSON object", additionalProperties: true },
+            },
+        },
+    },
+    {
+        name: "get_openapi_spec",
+        description: "OpenAPI 3.0 스펙을 JSON으로 반환합니다. API 구조, 요청/응답 스키마, 인증 방법을 포함합니다.",
+        inputSchema: { type: "object", properties: {} },
+    },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name: toolName, arguments: toolArgs } = request.params;
+
+    try {
+        switch (toolName) {
+            case "list_apis": {
+                const list = await fetchJSON("/api/fn");
+                return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
+            }
+            case "call_query": {
+                const path = "/api/fn/" + toolArgs.name.replace(/\./g, "/");
+                const result = await postJSON(path, toolArgs.args || {});
+                return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+            }
+            case "call_mutation": {
+                const path = "/api/fn/" + toolArgs.name.replace(/\./g, "/");
+                const result = await postJSON(path, toolArgs.args || {});
+                return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+            }
+            case "get_openapi_spec": {
+                const spec = await fetchJSON("/api/openapi.json");
+                return { content: [{ type: "text", text: JSON.stringify(spec, null, 2) }] };
+            }
+            default:
+                return { content: [{ type: "text", text: `Unknown tool: ${toolName}` }], isError: true };
+        }
+    } catch (err) {
+        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+});
+
+// ── Resources ───────────────────────────────────────────
+
+const RESOURCES = [
+    {
+        uri: "gencow://openapi-spec",
+        name: "openapi-spec",
+        description: "Gencow OpenAPI 3.0 specification (auto-generated from registered queries/mutations)",
+        mimeType: "application/json",
+    },
+    {
+        uri: "gencow://api-list",
+        name: "api-list",
+        description: "List of all registered API endpoints with paths and methods",
+        mimeType: "application/json",
+    },
+];
+
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: RESOURCES }));
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+
+    switch (uri) {
+        case "gencow://openapi-spec": {
+            const spec = await fetchJSON("/api/openapi.json");
+            return { contents: [{ uri, mimeType: "application/json", text: JSON.stringify(spec, null, 2) }] };
+        }
+        case "gencow://api-list": {
+            const list = await fetchJSON("/api/fn");
+            return { contents: [{ uri, mimeType: "application/json", text: JSON.stringify(list, null, 2) }] };
+        }
+        default:
+            throw new Error(`Unknown resource: ${uri}`);
+    }
+});
+
+// ── Start ───────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);