MCP サーバー スターター

TypeScript を使用して Model Context Protocol (MCP) サーバーを構築するための、本番環境対応のスターター テンプレート。

🚀 クイックスタート

1. リポジトリをクローンする

2. 依存関係をインストールします:

   bun install

Related MCP server: MCP Server Starter

✨ 主な特徴

• 高速テストと開発のための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

開発用 MCP サーバーを Claude Desktop に追加するには:

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を使用してバージョン番号を更新することを忘れないでください。

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