MCP Server Example

이 프로젝트는 StreamableHTTPServerTransport를 사용한 Remote MCP (Model Context Protocol) 서버의 구현 예제입니다.

💡 팁: MCP 서버를 처음 사용하시는 경우, MCP 공식 문서를 참조하세요.

시작하기

의존성 설치

npm install

실행 방법

로컬 개발 환경

npm run dev

프로덕션 환경

npm run build
npm start

제공 도구

calculator

• 기능: 간단한 수식 계산 수행

user-list

• 기능: 특정 기간 동안의 사용자 목록 조회

user-statistics

• 기능: 특정 기간 동안의 가입자 통계 조회

환경 설정

환경 변수

변수명	설명	필수 여부
TOKEN	API 인증 토큰 Authorization 헤더와 일치하는 경우 인증	필수
ALLOWED_ORIGIN	CORS Origin	선택

환경 변수 설정 예시

# .env 파일
TOKEN=your-secret-token-here
ALLOWED_ORIGIN=

클라이언트 설정

Cursor IDE 설정

.cursor-settings.json 파일에 다음과 같이 설정:

{
  "mcpServers": {
    "example": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

📝 참고: <TOKEN>을 실제 환경변수 TOKEN 값으로 교체하세요.

API 엔드포인트

• Base URL: http://localhost:3000
• MCP Endpoint: /mcp

인증

서버는 Bearer Token 인증을 사용합니다:

Authorization: Bearer <TOKEN>

추가 정보

개발 환경 설정

# 의존성 설치
npm install

# 개발 서버 시작
npm run dev

프로덕션 배포

# 빌드
npm run build

# 프로덕션 서버 시작
npm start

문제 해결

자주 발생하는 문제들

• 401 Unauthorized: TOKEN 환경변수가 설정되어 있는지 확인
• Connection refused: 서버가 올바르게 시작되었는지 확인

📄 라이센스

MIT License