MCP 服务器

API MCP Server

A Model Context Protocol server that provides basic tools for arithmetic operations (addition) and dynamic greeting resources, demonstrating MCP integration patterns for other projects and clients.

README

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