MCP 서버 스타터

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

🚀 빠른 시작

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

Related MCP server: MCP Server Template

✨ 주요 특징

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

📂 프로젝트 구조

mcp-starter/ ├── src/ │ ├── tools/ # MCP tools implementation │ ├── utils/ # Shared utilities │ ├── main.ts # Server entry point │ └── types.ts # Shared type definitions ├── tests/ # Test files ├── biome.json # Linting configuration ├── tsconfig.json # TypeScript configuration └── package.json # Project dependencies

⚙️ 구성

새로운 도구 만들기

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

bun run scripts/create-tool.ts <tool-name>

이렇게 하면:

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

예:

bun run scripts/create-tool.ts weather

🛠️ 개발

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

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

프로젝트를 빌드하세요:
bun run build
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에 게시

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

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

npm에서 설치(게시 후)

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

// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "npx", "args": ["-y", "your-package-name", "some_argument"] } } }