MCP 서버 스타터

TypeScript를 사용하여 MCP(Model Context Protocol) 서버를 구축하기 위한 프로덕션에 바로 적용 가능한 스타터 템플릿입니다.

🚀 빠른 시작

1. 저장소를 복제합니다
2. 종속성 설치:지엑스피1

✨ 주요 특징

• 빠른 테스트 및 개발을 위한 Bun
• 린팅 및 포맷팅을 위한 바이옴
• 표준 버전을 사용한 자동화된 버전 관리
• 깔끔하고 유지 관리가 가능한 프로젝트 구조

📂 프로젝트 구조

⚙️ 구성

새로운 도구 만들기

이 프로젝트에는 새로운 MCP 도구를 만드는 데 도움이 되는 스크립트가 포함되어 있습니다.

이렇게 하면:

1. src/tools/<tool-name> 아래에 새 도구 디렉토리를 만듭니다.
2. 다음을 포함한 기본 도구 구조를 생성합니다.
   • index.ts (주요 구현)
   • schema.ts(도구 매개변수에 대한 JSON 스키마)
   • test.ts(테스트 파일)
3. 새 도구를 내보내려면 도구 인덱스 파일을 업데이트하세요.

예:

🛠️ 개발

• 테스트 실행 : bun test
• 포맷 코드 : bun run format
• 린트 코드 : bun run lint
• 프로젝트 빌드 : bun run build

Claude Desktop에 개발 MCP 서버를 추가하려면:

1. 프로젝트를 빌드하세요:
   bun run build
2. Claude Desktop 구성에 다음을 추가합니다.
   // You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

📜 버전 관리

이 프로젝트에서는 자동화된 버전 관리를 위해 standard-version을 사용합니다. bun run release 실행하여 새 버전을 생성하세요.

커밋 메시지 형식

• feat : 새로운 기능(부 버전 추가)
• fix : 버그 수정(범프 패치 버전)
• BREAKING CHANGE : 주요 변경 사항(주요 버전 변경)

📦 npm에 게시

1. npm에 로그인했는지 확인하세요.
   npm login
2. 프로젝트를 빌드하세요:
   bun run build
3. 패키지를 게시합니다.
   npm publish

새로운 버전을 게시하기 전에 bun run release 사용하여 버전 번호를 업데이트하는 것을 잊지 마세요.

npm에서 설치(게시 후)

Claude Desktop 구성에 다음을 추가합니다.