MCP Server Template

MCP Server Template

前提条件

LLM CLI のインストール

このプロジェクトには、LLM CLI がインストールされている必要があります。Homebrew を使用してインストールできます。

brew install llm

インストール後、次のコマンドを実行して、llm コマンドが PATH から利用できることを確認してください。

llm --version

はじめに

開発

1. 依存関係をインストールします。

   npm install
   

2. ホットリロードを有効にして開発サーバーを起動します。

   npm run dev
   

3. プロジェクトをビルドします。

   npm run build
   

4. テストを実行します。

   npm test
   

5. 本番サーバーを起動します。

   npm start
   

Architect ツール

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

機能

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

要件

• LLM CLI がインストールされ、PATH から利用できる必要があります（「前提条件」セクションを参照）
• LLM CLI の環境変数が適切に設定されている必要があります

テスト

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

TestClient の使用

TestClient を使用すると、ツールを簡単にテストできます。

import { TestClient } from "./utils/TestClient";

describe("YourTool", () => {
  const client = new TestClient();

  it("should process data correctly", async () => {
    await client.assertToolCall(
      "your-tool-name",
      { input: "test" },
      (result) => {
        expect(result.toolResult.content).toBeDefined();
      }
    );
  });
});

MCP Inspector の使用

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

1. Inspector を起動します。

   npx @modelcontextprotocol/inspector node dist/index.js
   

2. http://localhost:5173 で Inspector UI を開きます。

Inspector では、次の操作を行えます。

• ツールをテストするための視覚的なインターフェース
• リクエストとレスポンスのリアルタイム監視
• ツールのメタデータの確認
• 対話型テスト環境

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

Cursor を使って MCP サーバーをローカルでテストするには、次の手順を実行します。

1. パッケージをビルドしてリンクします。

   npm run build
   npm run link
   

2. バイナリが動作することを確認します。

   npx architect-test-mcp-tool
   

3. サーバーを Cursor に追加します。

   • Cursor の設定を開きます
   • Features タブに移動します
   • MCP Servers セクションまでスクロールします
   • 「Add Server」をクリックします
   • 「Command」タイプを選択します
   • 名前（例：「Local Example Tool」）を付けます
   • コマンドとして npx architect-test-mcp-tool を入力します
   • 「Confirm」をクリックします

4. MCP Servers セクションでサーバーが実行中と表示されていることを確認し、Cursor でサーバーが正しく起動することを確認します。

注：コードを変更した場合は、忘れずに再ビルドして再リンクしてください。

npm run build
npm run link

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

npm run unlink

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

トラブルシューティング

MCP Inspector の使用

MCP Inspector は、MCP サーバーのデバッグや確認に便利なツールです。使用するには、次の手順を実行します。

1. まず、プロジェクトをビルドします。

   npm run build
   

2. Inspector を実行します。

   npx @modelcontextprotocol/inspector node dist/index.js
   

Inspector には、次の操作ができるウェブインターフェースがあります。

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