Stevennevins Architect MCP Server

🚀 MCP サーバーテンプレート

このテンプレートは、MCP サーバーの開発を支援するためのもので、LLM CLI と連携してアーキテクチャ設計のフィードバックを得ることができます。

🚀 クイックスタート

前提条件

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

✨ 主な機能

アーキテクチャツール

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

• 複数のインタラクションにわたる会話コンテキストを維持します。
• LLM CLI を介したコマンドの実行を処理します。
• エラー処理とログ記録を提供します。
• 新しい会話と継続的な議論の 2 つのモードをサポートします。

要件

• LLM CLI がインストールされ、正しく構成されている必要があります（前提条件を参照）。
• 環境変数が正しく構成され、LLM CLI をサポートする必要があります。

💻 使用例

テストの実行

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 インスペクターの使用

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

1. インスペクターを起動します。

npx @modelcontextprotocol/inspector node dist/index.js

2. ブラウザでインスペクターのインターフェースを開きます。http://localhost:5173

インスペクターは以下の機能を提供します。

• ツールをテストするための可視化インターフェース。
• リアルタイムのリクエスト/レスポンスの監視。
• ツールのメタデータのチェック。
• 対話型のテスト環境。

Cursor を使用したローカルテスト

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

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

npm run build
npm run link

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

npx architect-test-mcp-tool

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

• Cursor の設定を開きます。
• 「機能」タブをクリックします。
• 一番下までスクロールし、「MCP サーバー」セクションを見つけます。
• 「サーバーを追加」をクリックします。
• 「コマンド」タイプを選択します。
• 名前を入力します（例：「ローカルサンプルツール」）。
• コマンドを入力します：npx architect-test-mcp-tool
• 「確認」をクリックします。

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

注意：コードを変更した場合は、再度ビルドしてリンクする必要があります。

npm run build
npm run link

テストが完了したら、以下のコマンドでリンクを解除できます。

npm run unlink

このコマンドは、開発中に作成されたグローバルシンボリックリンクを削除します。

🔧 技術詳細

インスペクター機能

• 会話コンテキストの維持：ツールが複数のインタラクションで一貫したコンテキストを維持することを保証します。
• LLM コマンドの処理：CLI を介して大規模言語モデル関連の操作を実行します。
• エラー処理とログ記録：詳細なエラー情報とログを提供し、デバッグを支援します。

依存関係管理

Node パッケージマネージャー（npm）を使用して、依存関係のインストールとバージョン管理を行い、プロジェクトが正常に動作するようにします。