@koseha/api-mcp 0.0.0

package/README.md

@@ -0,0 +1,235 @@
+# API MCP 서버
+
+Model Context Protocol (MCP) 서버입니다. 다른 프로젝트나 MCP 클라이언트에서 도구와 리소스를 제공합니다.
+
+## 기능
+
+- **도구 (Tools)**: `add` - 두 숫자를 더하는 도구
+- **리소스 (Resources)**: `greeting://{name}` - 동적 인사말 생성 리소스
+
+## 다른 프로젝트에서 사용하기
+
+### 방법 1: NPM 패키지로 배포하기
+
+#### 1단계: 패키지 빌드
+
+```bash
+npm run build
+```
+
+#### 2단계: NPM에 배포 (선택사항)
+
+```bash
+npm publish
+```
+
+또는 로컬 레지스트리나 private registry 사용
+
+#### 3단계: 다른 프로젝트에서 설치
+
+```bash
+cd ../다른-프로젝트
+npm install api-mcp
+```
+
+#### 4단계: 실행 파일로 사용
+
+다른 프로젝트에서 직접 실행:
+
+```javascript
+import { spawn } from 'child_process';
+import { join } from 'path';
+
+const mcpServer = spawn('npx', ['api-mcp'], {
+  stdio: ['pipe', 'pipe', 'pipe']
+});
+```
+
+### 방법 2: 로컬 패키지로 사용 (개발 중)
+
+#### 1단계: npm link 설정
+
+현재 프로젝트에서:
+
+```bash
+npm link
+```
+
+#### 2단계: 다른 프로젝트에서 링크
+
+다른 프로젝트에서:
+
+```bash
+cd ../다른-프로젝트
+npm link api-mcp
+```
+
+이제 다른 프로젝트에서 `npx api-mcp` 명령어를 사용할 수 있습니다.
+
+### 방법 3: 상대 경로로 사용
+
+다른 프로젝트의 `package.json`에 추가:
+
+```json
+{
+  "dependencies": {
+    "api-mcp": "file:../api-mcp"
+  }
+}
+```
+
+그런 다음:
+
+```bash
+npm install
+```
+
+### 방법 4: MCP 클라이언트에서 사용 (Claude Desktop 등)
+
+#### Claude Desktop 설정
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 또는 
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows) 파일에 추가:
+
+```json
+{
+  "mcpServers": {
+    "api-mcp": {
+      "command": "node",
+      "args": ["C:/Users/saems/Desktop/project/mcps/api-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+또는 글로벌 설치 후:
+
+```json
+{
+  "mcpServers": {
+    "api-mcp": {
+      "command": "npx",
+      "args": ["-y", "api-mcp"]
+    }
+  }
+}
+```
+
+### 방법 5: Node.js 프로젝트에서 직접 사용
+
+다른 Node.js 프로젝트에서:
+
+```javascript
+// client.js
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// MCP 서버 경로 (상대 또는 절대 경로)
+const serverPath = join(__dirname, '../api-mcp/dist/index.js');
+
+const mcpServer = spawn('node', [serverPath], {
+  stdio: ['pipe', 'pipe', 'pipe']
+});
+
+// JSON-RPC 요청 보내기
+function sendRequest(method, params) {
+  const request = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method,
+    params: params || {}
+  };
+  mcpServer.stdin?.write(JSON.stringify(request) + '\n');
+}
+
+// 응답 수신
+let buffer = '';
+mcpServer.stdout?.on('data', (data) => {
+  buffer += data.toString();
+  const lines = buffer.split('\n');
+  buffer = lines.pop() || '';
+  
+  for (const line of lines) {
+    if (line.trim()) {
+      try {
+        const response = JSON.parse(line);
+        console.log('응답:', response);
+      } catch (e) {
+        // 파싱 오류 무시
+      }
+    }
+  }
+});
+
+// 초기화
+sendRequest('initialize', {
+  protocolVersion: '2024-11-05',
+  capabilities: {
+    tools: {},
+    resources: {}
+  },
+  clientInfo: {
+    name: 'my-client',
+    version: '1.0.0'
+  }
+});
+
+// 도구 호출 예시
+setTimeout(() => {
+  sendRequest('tools/call', {
+    name: 'add',
+    arguments: { a: 5, b: 3 }
+  });
+}, 1000);
+```
+
+## 개발
+
+### 빌드
+
+```bash
+npm run build
+```
+
+### 실행
+
+```bash
+npm start
+```
+
+### 테스트 클라이언트 실행
+
+```bash
+node test-client.js
+```
+
+## 프로젝트 구조
+
+```
+api-mcp/
+├── src/
+│   ├── index.ts          # MCP 서버 메인 파일
+│   └── tools/
+│       └── listEndpoints.ts
+├── dist/
+│   └── index.js          # 빌드된 파일
+├── package.json
+└── README.md
+```
+
+## 의존성
+
+- `@modelcontextprotocol/sdk`: MCP SDK
+- `zod`: 스키마 검증
+- `typescript`: 타입스크립트 컴파일러
+
+## 참고 자료
+
+- [MCP 공식 문서](https://modelcontextprotocol.io)
+- [MCP SDK GitHub](https://github.com/modelcontextprotocol/typescript-sdk)
+
+

package/dist/index.js

@@ -0,0 +1,23 @@
+import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+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.");

package/dist/tools/listEndpoints.js

@@ -0,0 +1,5 @@
+export function registerListEndpointsTool(server, endpoints) {
+    server.tool("list_endpoints", "List all API endpoints", {}, async () => {
+        return endpoints.map((e) => `${e.method} ${e.path}`);
+    });
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@koseha/api-mcp",
+  "version": "0.0.0",
+  "description": "An API MCP based on Swagger docs",
+  "keywords": [],
+  "homepage": "https://github.com/koseha/api-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/koseha/api-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/koseha/api-mcp.git"
+  },
+  "license": "ISC",
+  "author": "koseha",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "api-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "npm run build && npm run start"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "yaml": "^2.8.2",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}