MCP 服务器

POC Node MCP Server

A proof-of-concept MCP server for learning and testing, providing basic arithmetic and weather tools, along with greeting and user profile resources.

README

POC Node MCP Server

POC (Proof of Concept) - MCP(Model Context Protocol) 서버 개발 학습 및 테스트를 위한 데모 프로젝트입니다.

다양한 계산 도구와 사용자 정보 리소스를 제공하는 MCP 서버로, MCP 서버 개발 방법을 학습하고 테스트할 수 있습니다.

🎯 프로젝트 목적

MCP 서버 개발 방법 학습
Tool과 Resource의 차이점 이해
LLM과의 연동 테스트
npm 패키지 배포 및 npx 실행 테스트

설치

npm install -g poc-node-mcp-server

또는 npx로 직접 실행:

npx poc-node-mcp-server

제공하는 기능

Tools (도구)

1. add - 수학 계산

두 숫자를 입력받아 그 합을 반환합니다.

{
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 5,
      "b": 3
    }
  }
}

2. get_weather - 날씨 정보 조회

도시 이름을 입력받아 해당 도시의 랜덤 날씨 정보를 반환합니다.

{
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {
      "city": "서울"
    }
  }
}

Resources (리소스)

1. greeting - 인사말

사용자 이름을 받아 인사말을 생성합니다.

URI: greeting://홍길동

2. user_profile - 사용자 프로필

사용자 이름을 받아 랜덤한 프로필 정보를 생성합니다.

URI: user_profile://김철수

Gemini CLI 연동

.gemini/settings.json 파일에 다음 설정을 추가하세요:

{
  "mcpServers": {
    "demo-mcp-server": {
      "command": "npx",
      "args": ["poc-node-mcp-server"],
      "description": "POC MCP 서버 - 학습 및 테스트용 다양한 계산 도구와 사용자 정보 리소스 제공"
    }
  }
}

사용 예시

LLM과의 대화

사용자: "5와 3을 더해줘"
LLM: add 도구를 사용하여 8을 반환

사용자: "서울의 날씨를 알려줘"
LLM: get_weather 도구를 사용하여 "서울의 현재 날씨: 맑음, 기온: 15°C, 습도: 65%" 반환

사용자: "홍길동에게 인사해줘"
LLM: greeting://홍길동 리소스에 접근하여 "안녕하세요, 홍길동님!" 반환

사용자: "김철수의 프로필을 보여줘"
LLM: user_profile://김철수 리소스에 접근하여 랜덤 프로필 정보 반환

개발

로컬 개발 환경 설정

# 의존성 설치
npm install

# TypeScript 빌드
npm run build

# 개발 모드 실행
npm run dev

# 테스트 실행
npm test

프로젝트 구조

poc-node-mcp-server/
├── src/
│   └── index.ts          # 메인 MCP 서버 코드
├── dist/
│   └── index.js          # 빌드된 JavaScript 파일
├── test-mcp.js           # MCP 서버 테스트 스크립트
├── package.json          # 프로젝트 설정
├── tsconfig.json         # TypeScript 설정
├── MCP_Learning_Guide.md # MCP 학습 가이드
└── README.md            # 프로젝트 문서