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 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.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

hello_tool

モデルコンテキストプロトコルサーバーを構築するための TypeScript ベースのテンプレートで、高速テスト、自動バージョン管理、MCP ツール実装用のクリーンな構造が特徴です。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Starter
StevenStavrakis
A
security
A
license
A
quality
A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
Last updated -
1
1
12
JavaScript
MIT License
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
1
JavaScript
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
Last updated -
1
5
TypeScript
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