MCP スターターサーバー

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

特徴

• シンプルな「Hello World」ツールの例

• TypeScript + esbuild のセットアップ

• 開発ツールが事前設定されている

Related MCP server: MCP Server Scaffold

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 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

または、ウォッチャーとインスペクターの両方を実行します。

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実装を参照してください。