hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for linting and formatting in the project
Used for fast testing and development in the project
The project can be published to npm registry

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

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

hello_tool

빠른 테스트, 자동화된 버전 관리, MCP 도구 구현을 위한 깔끔한 구조를 갖춘 모델 컨텍스트 프로토콜 서버를 구축하기 위한 TypeScript 기반 템플릿입니다.

Related Resources

Reddit Discussion about this server