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 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"]
    }
  }
}

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

hello_tool

TypeScript를 사용하여 모델 컨텍스트 프로토콜 서버를 생성하기 위한 프로덕션에 바로 적용 가능한 템플릿으로, 효율적인 테스트, 개발 및 배포를 위한 도구를 제공합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Starter
coinselor
A
security
A
license
A
quality
A 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
7
JavaScript
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A 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 -
1
2
TypeScript
MCP Server Starter
GreatAuk
A
security
A
license
A
quality
A 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 -
1
7
2
TypeScript
MIT License
MCP Framework
ronangrant
-
security
F
license
-
quality
A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
Last updated -
67
TypeScript

View all related MCP servers

MCP Server Starter