MCP Starter

🚀 MCP 起動サーバー

最小限の モデルコンテキストプロトコル サーバーテンプレートで、AI アシスタントツールを構築するために使用されます。このスターターは、AI アシスタント（Claude など）と互換性のある MCP ツールを作成するための基本構造を提供します。

✨ 主な機能

• シンプルな "こんにちは、世界" ツールのサンプル
• TypeScript + esbuild のセットアップ
• 開発ツールの事前設定

📦 インストール

Claude と一緒に使用するためのセットアップ手順は以下の通りです。

1. Claude Desktop アプリ をダウンロードしてインストールします。

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

npm install
npm run build

3. Claude がこの MCP サーバーを使用するように設定します。最初の 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 を使用して開発を行い、Claude でテストすることができます。MCP サーバーを再起動するたびに、Claude を再起動する必要があります。

💻 使用例

インスペクターを使用した開発

開発やデバッグの目的で、MCP インスペクターツールを使用することができます。インスペクターは、MCP サーバーのやり取りをテストおよび監視するための視覚的なインターフェイスを提供します。

詳細な設定手順については、インスペクターのドキュメント を参照してください。

ローカルでテストするには、以下のコマンドを実行します。

npm run inspect

ファイルが変更されたときにビルドするには、以下のコマンドを実行します。

npm run watch

または、ウォッチャーとインスペクターを同時に実行するには、以下のコマンドを実行します。

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 の実装をサンプルとして参照してください。