MCP サーバー テンプレート

前提条件

LLM CLI インストール

このプロジェクトではLLM CLIのインストールが必要です。Homebrewを使ってインストールできます。

インストール後、次のコマンドを実行して、PATH でllmコマンドが使用可能であることを確認します。

はじめる

発達

1. 依存関係をインストールします:
   npm install
2. ホット リロードで開発サーバーを起動します。
   npm run dev
3. プロジェクトをビルドします。
   npm run build
4. テストを実行します:
   npm test
5. 本番サーバーを起動します。
   npm start

アーキテクトツール

Architect ツール ( src/tools/architect.ts ) は、LLM CLI と対話してアーキテクチャ設計のフィードバックを得るためのインターフェースを提供します。会話コンテキストを維持し、アプリケーションと LLM CLI 間の通信を処理します。

特徴

• 複数のやり取りにわたって会話のコンテキストを維持する
• LLM CLI を通じてコマンド実行を処理します
• エラー処理とログ記録を提供します
• 新しい会話と継続的な議論の両方をサポートします

要件

• LLM CLI がインストールされ、PATH で利用可能である必要があります (前提条件セクションを参照)
• LLM CLIの環境変数は適切に設定されている必要があります

テスト

テンプレートには、ローカル テスト用の組み込み TestClient と視覚的なデバッグ用の MCP Inspector が含まれています。

TestClientの使用

TestClient はツールをテストする簡単な方法を提供します。

MCPインスペクターの使用

テンプレートには、ツールを視覚的にデバッグするための MCP インスペクターが含まれています。

1. インスペクターを起動します。
   npx @modelcontextprotocol/inspector node dist/index.js
2. http://localhost:5173でインスペクターUIを開きます。

検査官は以下を提供します:

• テストツールのビジュアルインターフェース
• リアルタイムのリクエスト/レスポンス監視
• ツールメタデータ検査
• インタラクティブなテスト環境

カーソルを使ったローカルテスト

Cursor を使用して MCP サーバーをローカルでテストするには:

1. パッケージをビルドしてリンクします。
   npm run build npm run link
2. バイナリが動作することを確認します。
   npx architect-test-mcp-tool
3. カーソルにサーバーを追加します。
   • カーソル設定を開く
   • 機能タブに移動します
   • MCPサーバーのセクションまでスクロールします
   • 「サーバーを追加」をクリックします
   • 「コマンド」タイプを選択
   • 名前を付けます（例：「ローカルサンプルツール」）
   • 次のコマンドを入力します: npx architect-test-mcp-tool
   • 確認をクリック
4. MCP サーバー セクションでサーバーが実行中であることが表示されていることを確認し、カーソルでサーバーが正しく起動していることを確認します。

注意: コードを変更した場合は、必ず再構築して再リンクしてください。

テストが完了したら、パッケージのリンクを解除できます。

これにより、開発中に作成されたグローバル シンボリック リンクが削除されます。

トラブルシューティング

MCPインスペクターの使用

MCP Inspectorは、MCPサーバーのデバッグと検査に役立つツールです。使い方は以下のとおりです。

1. まず、プロジェクトをビルドします。
   npm run build
2. インスペクターを実行します:
   npx @modelcontextprotocol/inspector node dist/index.js

インスペクターは、次の操作を実行できる Web インターフェースを提供します。

• 利用可能なすべてのツールとそのスキーマを表示する
• テストツールは対話的に呼び出します
• リクエスト/レスポンスペイロードを検査する
• サーバーとクライアント間の通信の問題をデバッグする