API MCP 서버

Model Context Protocol (MCP) 서버입니다. 다른 프로젝트나 MCP 클라이언트에서 도구와 리소스를 제공합니다.

기능

• 도구 (Tools): add - 두 숫자를 더하는 도구
• 리소스 (Resources): greeting://{name} - 동적 인사말 생성 리소스

다른 프로젝트에서 사용하기

방법 1: NPM 패키지로 배포하기

1단계: 패키지 빌드

npm run build

2단계: NPM에 배포 (선택사항)

npm publish

또는 로컬 레지스트리나 private registry 사용

3단계: 다른 프로젝트에서 설치

cd ../다른-프로젝트
npm install api-mcp

4단계: 실행 파일로 사용

다른 프로젝트에서 직접 실행:

import { spawn } from 'child_process';
import { join } from 'path';

const mcpServer = spawn('npx', ['api-mcp'], {
  stdio: ['pipe', 'pipe', 'pipe']
});

방법 2: 로컬 패키지로 사용 (개발 중)

1단계: npm link 설정

현재 프로젝트에서:

npm link

2단계: 다른 프로젝트에서 링크

다른 프로젝트에서:

cd ../다른-프로젝트
npm link api-mcp

이제 다른 프로젝트에서 npx api-mcp 명령어를 사용할 수 있습니다.

방법 3: 상대 경로로 사용

다른 프로젝트의 package.json에 추가:

{
  "dependencies": {
    "api-mcp": "file:../api-mcp"
  }
}

그런 다음:

npm install

방법 4: MCP 클라이언트에서 사용 (Claude Desktop 등)

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows) 파일에 추가:

{
  "mcpServers": {
    "api-mcp": {
      "command": "node",
      "args": ["C:/Users/saems/Desktop/project/mcps/api-mcp/dist/index.js"]
    }
  }
}

또는 글로벌 설치 후:

{
  "mcpServers": {
    "api-mcp": {
      "command": "npx",
      "args": ["-y", "api-mcp"]
    }
  }
}

방법 5: Node.js 프로젝트에서 직접 사용

다른 Node.js 프로젝트에서:

// 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);

개발

빌드

npm run build

실행

npm start

테스트 클라이언트 실행

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 공식 문서
• MCP SDK GitHub