계산기 MCP 서버

Model Context Protocol (MCP)을 사용한 계산기 서버입니다. 더하기, 빼기, 곱하기, 나누기 기능을 제공합니다.

기능

이 MCP 서버는 다음 4가지 도구를 제공합니다:

• add (더하기): 두 숫자를 더합니다
• subtract (빼기): 첫 번째 숫자에서 두 번째 숫자를 뺍니다
• multiply (곱하기): 두 숫자를 곱합니다
• divide (나누기): 첫 번째 숫자를 두 번째 숫자로 나눕니다 (0으로 나누기 방지)

설치

npm으로 설치 (권장)

npm install -g calculator-mcp-server

소스에서 설치

# 저장소 클론
git clone https://github.com/yourusername/calculator-mcp-server.git
cd calculator-mcp-server

# 의존성 설치
npm install

# TypeScript 컴파일
npm run build

사용 방법

Claude Desktop에서 사용하기

npm으로 설치한 경우

1. Claude Desktop 설정 파일을 엽니다:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 다음 설정을 추가합니다:

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

소스에서 설치한 경우

1. Claude Desktop 설정 파일을 엽니다 (위와 동일)

2. 다음 설정을 추가합니다:

{
  "mcpServers": {
    "calculator": {
      "command": "node",
      "args": [
        "/절대/경로/calculator-mcp-server/build/index.js"
      ]
    }
  }
}

중요: args 배열의 경로를 실제 프로젝트 경로로 변경해야 합니다.

사용 예시

Claude Desktop을 재시작한 후, 다음과 같이 사용할 수 있습니다:

• "100 더하기 50은 얼마야?"
• "500에서 200을 빼면?"
• "25 곱하기 4는?"
• "100을 5로 나누면?"

직접 실행 (테스트용)

npm start

개발

# 개발 모드 (자동 컴파일)
npm run dev

프로젝트 구조

calculator-mcp-server/
├── src/
│   └── index.ts        # MCP 서버 메인 코드
├── build/              # 컴파일된 JavaScript 파일
├── package.json        # 프로젝트 설정
├── tsconfig.json       # TypeScript 설정
└── README.md           # 이 파일

기술 스택

• TypeScript: 타입 안전한 코드 작성
• @modelcontextprotocol/sdk: MCP TypeScript SDK
• Zod: 스키마 검증
• Node.js: 런타임 환경

예시 응답

더하기 도구를 사용하면 다음과 같은 응답을 받습니다:

{
  "result": 150,
  "operation": "addition",
  "expression": "100 + 50 = 150"
}

npm 배포 방법

배포 전 체크리스트

1. package.json에서 다음 항목을 수정하세요:

   • name: npm에서 고유한 패키지 이름 (이미 사용 중인지 확인)
   • author: 작성자 정보
   • repository: GitHub 저장소 URL
   • bugs, homepage: 프로젝트 URL

2. npm 계정이 있는지 확인:

   npm login

3. 패키지 이름이 사용 가능한지 확인:

   npm view calculator-mcp-server
   # "404 Not Found"가 나오면 사용 가능

배포하기

# 1. 버전 업데이트 (선택사항)
npm version patch  # 1.0.0 -> 1.0.1
# 또는
npm version minor  # 1.0.0 -> 1.1.0
# 또는
npm version major  # 1.0.0 -> 2.0.0

# 2. npm에 배포
npm publish

# 3. 배포 확인
npm view calculator-mcp-server

배포 후 테스트

# 전역 설치 테스트
npm install -g calculator-mcp-server

# 실행 테스트
calculator-mcp

라이선스

MIT