MCP Test Client

🚀 MCP テストクライアント

MCP ミドルウェアで、Claude とテスト対象サーバーの両端をテストするツールです。開発期間中に MCP サーバーのテストに使用されます。

🚀 クイックスタート

MCP テストクライアントは、Claude とテスト対象サーバーの間でテストを行うためのツールです。以下のセクションでは、そのアーキテクチャ、機能、実装、インストール、使用方法、開発フロー、および将来の拡張計画について説明します。

✨ 主な機能

• テスト環境に MCP サーバーをデプロイする
• カスタムパラメータを持つ単一のツールを呼び出す
• 自動テストスイートを実行する
• サーバーログを表示する
• Claude に正式に登録する前にサーバーをテストする

🔧 技術詳細

アーキテクチャ

MCP テストクライアントは二重の役割を持っています：

• サーバー：Claude に登録され、テスト用のツールを公開します。
• クライアント：他の MCP サーバーに接続してテストを行います。

┌─────────────┐          ┌───────────────────┐          ┌────────────────┐
│             │  ツール    │                   │  クライアント    │                │
│   Claude    │─────────>│  MCP テストクライアント  │─────────>│  テスト対象サーバー     │
│             │          │                   │          │                │
└─────────────┘          └───────────────────┘          └────────────────┘

このアーキテクチャにより、Claude に直接登録することなく MCP サーバーをテストすることができます。

実装

MCP テストクライアントは以下の技術を使用して実装されています：

• プロセス管理：MCP サーバープロセスを生成し、管理します。
• 公式 MCP SDK クライアント：公式の MCP SDK を使用してサーバーと通信します。
• カスタムトランスポート：標準入出力通信のためのカスタムトランスポートを実装します。
• テスト実行：テストを実行し、応答を検証します。
• CLI インターフェース：対話型のテストインターフェースを提供します。

現在の実装は設計計画の第 1 段階であり、将来的に第 2 段階と第 3 段階の拡張が計画されています。

📦 インストール

# 依存関係をインストールする
npm install

# TypeScript プロジェクトをビルドする
npm run build

💻 使用例

基本的な使用法

MCP サーバーとして

MCP テストクライアントは claude-mcp-local スクリプトを介して Claude に登録されます。以下のツールを使用できます：

1. サーバーをデプロイする：

mcp__mcp-test__mcp_test_deploy_server({
  name: "my-server",
  source_path: "/path/to/server",
  env_vars: {
    "API_KEY": "${API_KEY}"
  }
})

2. デプロイされたサーバー上のツールを呼び出す：

mcp__mcp-test__mcp_test_call_tool({
  server_name: "my-server",
  tool_name: "tool_name",
  arguments: {
    // ツール固有のパラメータ
  }
})

3. サーバーに対してテストを実行する：

mcp__mcp-test__mcp_test_run_tests({
  server_name: "my-server"
})

4. サーバーのログを表示する：

mcp__mcp-test__mcp_test_get_logs({
  server_name: "my-server",
  lines: 100
})

5. デプロイされたサーバーをリストする：

mcp__mcp-test__mcp_test_list_servers({})

6. サーバーを停止する：

mcp__mcp-test__mcp_test_stop_server({
  server_name: "my-server"
})

CLI ツールとして

CLI インターフェースを使用してテストを実行するには、以下のコマンドを実行します：

# npm スクリプトを使用する
npm run test

# または直接実行する
node dist/test-runner.js

これにより、MCP サーバーのデプロイ、テスト、および管理を行うための対話型メニューが表示されます。

📚 ドキュメント

開発フロー

MCP テストクライアントは以下の開発フローをサポートしています：

1. プレイグラウンドディレクトリで MCP サーバーを開発する
2. MCP テストクライアントを使用してテスト環境にデプロイする
3. 機能をテストし、単一のツールを呼び出してデバッグする
4. 問題を修正し、サーバーが正常に動作するまで繰り返す
5. サーバーを mcp-servers/ ディレクトリに移動する
6. claude-mcp-local を介して Claude に登録する

将来の拡張計画

計画されている拡張には以下のものが含まれます：

• 第 2 段階：Docker ベースのコンテナ管理、包括的なテストスイート
• 第 3 段階：移行ツール、より高度なテスト検証

完全な設計ドキュメントについては、notes/mcp_test_client_design.md を参照してください。