@koseha/api-mcp 0.0.1 → 0.0.3

package/dist/index.js

@@ -1,23 +1,20 @@
-import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * MCP 서버 엔트리포인트
+ */
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-const server = new McpServer({
-    name: "api-mcp",
-    version: "1.0.0",
-});
-server.registerTool("add", {
-    title: "Addition Tool",
-    description: "Add two numbers",
-    inputSchema: { a: z.number(), b: z.number() },
-}, async ({ a, b }) => ({
-    content: [{ type: "text", text: String(a + b) }],
-}));
-server.registerResource("greeting", new ResourceTemplate("greeting://{name}", { list: undefined }), {
-    title: "Greeting Resource",
-    description: "Dynamic greeting generator",
-}, async (uri, { name }) => ({
-    contents: [{ uri: uri.href, text: `Hello, ${name}!` }],
-}));
-const transport = new StdioServerTransport();
-await server.connect(transport);
-console.log("MCP server is running via stdio.");
+import { createServer } from "./server.js";
+import { registerTools } from "./tools/index.js";
+import { registerResources } from "./resources/index.js";
+async function main() {
+    const server = createServer();
+    registerTools(server);
+    registerResources(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // 👇 이 줄이 핵심
+    // process.stdin.resume();
+}
+// main().catch((err) => {
+//   process.stderr.write(err.stack + "\n");
+//   process.exit(1);
+// });

package/dist/resources/greeting.resource.js

@@ -0,0 +1,9 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+export function registerGreetingResource(server) {
+    server.registerResource("greeting", new ResourceTemplate("greeting://{name}", { list: undefined }), {
+        title: "Greeting Resource",
+        description: "Dynamic greeting generator",
+    }, async (uri, { name }) => ({
+        contents: [{ uri: uri.href, text: `Hello, ${name}!` }],
+    }));
+}

package/dist/resources/index.js

@@ -0,0 +1,7 @@
+/**
+ * 모든 Resource 등록
+ */
+import { registerGreetingResource } from "./greeting.resource.js";
+export function registerResources(server) {
+    registerGreetingResource(server);
+}

package/dist/server.js

@@ -0,0 +1,10 @@
+/**
+ * MCPServer 생성
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export function createServer() {
+    return new McpServer({
+        name: "api-mcp",
+        version: "0.0.2",
+    });
+}

package/dist/swagger/swaggerLoader.js

@@ -0,0 +1,21 @@
+/**
+ * openapi.json 파일 읽기 + TTL 캐시
+ */
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let cache = null;
+let cachedAt = 0;
+const TTL = 5 * 60 * 1000; // 5분
+export async function loadSwagger() {
+    if (cache && Date.now() - cachedAt < TTL) {
+        return cache;
+    }
+    const openapiPath = join(__dirname, "../../openapi.json");
+    const fileContent = await readFile(openapiPath, "utf-8");
+    cache = JSON.parse(fileContent);
+    cachedAt = Date.now();
+    return cache;
+}

package/dist/tools/add.tool.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export function registerAddTool(server) {
+    server.registerTool("add", {
+        title: "Addition Tool",
+        description: "Add two numbers",
+        inputSchema: { a: z.number(), b: z.number() },
+    }, async ({ a, b }) => ({
+        content: [{ type: "text", text: String(a + b) }],
+    }));
+}

package/dist/tools/getApiDetail.tool.js

@@ -0,0 +1,28 @@
+/**
+ * Tool: API 상세 조회
+ */
+import { z } from "zod";
+import { loadSwagger } from "../swagger/swaggerLoader.js";
+export function registerGetApiDetail(server) {
+    server.registerTool("getApiDetail", {
+        title: "API 상세 조회",
+        description: "API 상세를 조회합니다.",
+        inputSchema: {
+            requestUrl: z.string(),
+            httpMethod: z.enum(["get", "post", "put", "delete", "patch"]),
+        },
+    }, async ({ requestUrl, httpMethod }) => {
+        if (!requestUrl || !httpMethod) {
+            return {
+                content: [
+                    { type: "text", text: "requestUrl 또는 httpMethod가 없습니다." },
+                ],
+            };
+        }
+        const swagger = await loadSwagger();
+        const api = swagger.paths[requestUrl][httpMethod];
+        return {
+            content: [{ type: "text", text: JSON.stringify(api) }],
+        };
+    });
+}

package/dist/tools/getApiList.tool.js

@@ -0,0 +1,16 @@
+/**
+ * Tool: API 목록 조회
+ */
+import { loadSwagger } from "../swagger/swaggerLoader.js";
+export function registerGetApiList(server) {
+    server.registerTool("getApiList", {
+        title: "API 목록 조회",
+        description: "API 목록을 조회합니다.",
+    }, async () => {
+        const swagger = await loadSwagger();
+        // paths → list 가공
+        return {
+            content: [{ type: "text", text: JSON.stringify(swagger.paths) }],
+        };
+    });
+}

package/dist/tools/getSchema.tool.js

@@ -0,0 +1 @@
+"use strict";

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+/**
+ * 모든 Tool 등록
+ */
+import { registerAddTool } from "./add.tool.js";
+import { registerGetApiList } from "./getApiList.tool.js";
+export function registerTools(server) {
+    registerAddTool(server);
+    registerGetApiList(server);
+}

package/openapi.json

@@ -0,0 +1,63 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Swagger Petstore - OpenAPI 3.0",
+    "version": "1.0.11"
+  },
+  "servers": [
+    {
+      "url": "https://petstore3.swagger.io/api/v3"
+    }
+  ],
+  "tags": [
+    {
+      "name": "pet",
+      "description": "당신의 애완동물에 대한 모든 것"
+    }
+  ],
+  "paths": {
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": ["pet"],
+        "summary": "이미지를 업로드합니다.",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "업데이트할 애완동물 ID",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          {
+            "name": "additionalMetadata",
+            "in": "query",
+            "description": "추가 메타데이터",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "성공적인 작업"
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koseha/api-mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "An API MCP based on Swagger docs",
   "keywords": [],
   "homepage": "https://github.com/koseha/api-mcp#readme",
@@ -25,7 +25,6 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "yaml": "^2.8.2",
     "zod": "^4.2.1"
   },
   "devDependencies": {