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 を使用して Model Context Protocol (MCP) サーバーを構築するための、本番環境対応のスターター テンプレート。
🚀 クイックスタート
リポジトリをクローンする
依存関係をインストールします:
bun install
✨ 主な特徴
高速テストと開発のための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
開発用 MCP サーバーを Claude Desktop に追加するには:
プロジェクトをビルドします。
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.