MCP Server Starter

🚀 MCP サーバー起動器

このツールは、TypeScript を使用して Model Context Protocol (MCP) サーバーを構築するための、本番環境に適したスタートテンプレートです。

🚀 クイックスタート

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   bun install
   

✨ 主な機能

• Bun を使用した高速なテストと開発
• Biome を使用したコードチェックとフォーマット
• standard-version による自動バージョン管理
• 明確で保守しやすいプロジェクト構造

📂 プロジェクト構造

mcp-starter/
├── src/
│   ├── tools/          # MCP ツールの実装
│   ├── utils/          # 共通ユーティリティクラス
│   ├── main.ts         # サーバーのエントリポイント
│   └── types.ts        # 共通の型定義
├── tests/              # テストファイル
├── biome.json          # コードチェックの設定
├── tsconfig.json       # TypeScript の設定
└── package.json        # プロジェクトの依存関係

⚙️ 設定

新しいツールの作成

このプロジェクトでは、新しい 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 の設定に追加します。

   // サーバーにパラメータを渡す必要がある場合のみこのパラメータが必要です
   {
     "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 の設定に以下の内容を追加します。

// サーバーにパラメータを渡す必要がある場合のみこのパラメータが必要です
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}

サーバーを起動するには、以下のコマンドを実行します。

npx your-package-name

💻 使用例

基本的な使用法

src/main.ts でのコード例です。

import { createServer } from 'http';

const server = createServer((req, res) => {
  res.writeHead(200);
  res.end('Hello MCP Server!');
});

server.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

ビルドして実行するには、以下のコマンドを実行します。

bun run build && bun run start