MCP Starter Server

MCP Starter Server

AI アシスタント向けツールを構築するための、最小限のModelContextProtocolサーバーテンプレートです。このスターターは、Claude などの AI アシスタントで使用できる MCP ツールを作成するための基本的な構成を提供します。

機能

• シンプルな「hello world」ツールの例
• TypeScript + esbuild のセットアップ
• 開発ツールの事前設定

Claude でビルドして実行するためのセットアップ

1. claude.ai/download から Claude デスクトップアプリをダウンロードしてインストールします

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

npm install
npm run build

3. この MCP サーバーを使用するよう Claude を設定します。初めて MCP サーバーを設定する場合は、このプロジェクトのルートで次を実行します：

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

次のようなエントリが claude_desktop_config.json に追加されます：

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

既存の MCP サーバーがある場合は、既存の設定に mcp-starter ブロックを追加します。重要な点として、args は <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs へのパスです。

4. Claude Desktop を再起動します。

5. Claude のインターフェースで、利用可能なツールの数が表示されたハンマーアイコンを探し、サーバーが実行中であることを確認します。

6. これがすべて正常に動作していれば、npm run dev を使って MCP サーバーを開発し、Claude でテストできます。MCP サーバーを再起動するには、その都度 Claude を再起動する必要があります。

Inspector を使った開発

開発やデバッグには、MCP Inspector ツールを使用できます。Inspector は、MCP サーバーとのやり取りをテストおよび監視するためのビジュアルインターフェースを提供します。

詳しいセットアップ手順については、Inspector のドキュメントを参照してください。

Inspector を使ってローカルでテストするには：

npm run inspect

ファイルの変更時にビルドするには：

npm run watch

または、ウォッチャーと Inspector の両方を実行します：

npm run dev

公開

サーバーを配布する準備ができたら、簡単に公開できます！

1. NPM アカウントを作成します。

2. npm publish を実行します。これにより、package.json のプロジェクト名を使ってパッケージが公開されます

3. 公開後、ほかのユーザーは次のような設定エントリを使ってサーバーをインストールできます：

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

利用可能なツール

このサーバーが提供するツール：

• hello_tool：名前をパラメーターとして受け取り、挨拶を返すシンプルなサンプルツール

新しいツールの作成

新しいツールを追加するには：

1. index.ts でツールのスキーマを定義します
2. ListToolsRequestSchema ハンドラーのツール配列に追加します
3. CallToolRequestSchema ハンドラーに実装を追加します

例として、hello_tool の実装を参照してください。