A
security-
licenseA
qualityA production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
Last updated -
1
158
MIT License
MCP 서버 스타터
TypeScript를 사용하여 MCP(Model Context Protocol) 서버를 구축하기 위한 프로덕션에 바로 적용 가능한 스타터 템플릿입니다.
🚀 빠른 시작
저장소를 복제합니다
종속성 설치:
지엑스피1
✨ 주요 특징
빠른 테스트 및 개발을 위한 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 buildClaude 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"]
}
}
}
Tools
TypeScript를 사용하여 모델 컨텍스트 프로토콜 서버를 생성하기 위한 프로덕션에 바로 적용 가능한 템플릿으로, 효율적인 테스트, 개발 및 배포를 위한 도구를 제공합니다.
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA TypeScript-based template for developing Model Context Protocol servers with features like dependency injection and service-based architecture, facilitating the creation and integration of custom data processing tools.Last updated -114
- Asecurity-licenseAqualityA TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.Last updated -11584MIT License
- -security-license-qualityA starter template for creating Model Context Protocol servers using TypeScript, providing basic setup and sample tool implementation for developers to build their own MCP servers.