MCP Server Starter

MCP Server Starter

TypeScript で MCP サーバーを構築するための、本番環境対応のスターターテンプレートです。

🚀 クイックスタート

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

   bun install
   

✨ 主な機能

• 高速なテストと開発のための Bun
• リントとフォーマットのための Biome
• standard-version によるバージョン管理の自動化
• クリーンで保守しやすいプロジェクト構成

📂 プロジェクト構成

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