MCP 서버 스타터

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

🚀 빠른 시작

1. 저장소를 복제합니다

2. 종속성 설치:

   지엑스피1

Related MCP server: MCP TypeScript 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>

이렇게 하면:

1. src/tools/<tool-name> 아래에 새 도구 디렉토리를 만듭니다.

2. 다음을 포함한 기본 도구 구조를 생성합니다.

   • index.ts (주요 구현)

   • schema.ts(도구 매개변수에 대한 JSON 스키마)

   • test.ts(테스트 파일)

3. 새 도구를 내보내려면 도구 인덱스 파일을 업데이트하세요.

예:

bun run scripts/create-tool.ts weather

🛠️ 개발

• 테스트 실행 : 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 사용하여 버전 번호를 업데이트하는 것을 잊지 마세요.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Weather MCP Server Starter를 자동으로 설치하려면:

npx -y @smithery/cli install @GreatAuk/mcp-weather --client claude

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