MCP Test

🚀 MCP Server Tester

このツールは、STDIOモードを使用して他のMCPサーバーをテストするための専用MCPサーバーで、TypeScriptで実装されています。

✨ 主な機能

• 接続テスト：対象のMCPサーバーの基本的な接続と初期化を検証します。
• 機能発見：すべてのツール、リソース、およびプロンプトを自動的に発見してリスト化します。
• ツール呼び出しテスト：特定のツールが正しく動作することをテストします。
• 明確なテストレポート：テストプロセスと結果を構造化された読みやすい形式で表示します。

📦 インストール

npxを使用する（推奨）

インストールせずにGitHubから直接MCP Testerを実行できます。

npx github:Peterpan-MU/MCP-Test

ローカルインストール

# リポジトリをクローンする
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test

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

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

💻 使用例

方法1：スタンドアロンのMCPサーバーとして

MCPクライアント（例：Claude Desktop）でこのサーバーを設定します。

オプションA：GitHubから直接（推奨）

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["-y", "github:Peterpan-MU/MCP-Test"]
    }
  }
}

オプションB：パッケージ名を使用する（ローカルインストール後）

# まず、グローバルにインストールするか、ローカルでリンクする
npm install -g github:Peterpan-MU/MCP-Test
# または
cd MCP-Test && npm link

次に設定します。

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["mcp-server-tester"]
    }
  }
}

オプションC：ローカル開発

{
  "mcpServers": {
    "mcp-tester": {
      "command": "node",
      "args": ["E:\\MCP Test\\dist\\index.js"]
    }
  }
}

その後、MCPクライアントからテストツールを呼び出します。

方法2：直接テストを実行する

# ローカルにインストールされている場合
npm test

# またはnpxで直接実行する
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test
npm install
npm test

利用可能なツール

1. test_server_connection

対象のMCPサーバーの基本的な接続機能をテストします。

パラメーター：

• command (文字列)：起動コマンド（例："node", "python", "uvx"）
• args (配列)：コマンド引数（例：["server.js"]）
• env (オブジェクト、オプション)：環境変数

例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "env": {
    "API_KEY": "your_key"
  }
}

出力：詳細な接続テストレポート。以下を含みます。

• 接続ステータス
• 初期化結果
• テストプロセスの手順

2. test_server_capabilities

対象のMCPサーバーのすべての機能を包括的にテストします。

パラメーター：

• command (文字列)：起動コマンド
• args (配列)：コマンド引数
• env (オブジェクト、オプション)：環境変数

例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"]
}

出力：完全な機能レポート。以下を含みます。

• 説明付きのすべての利用可能なツールのリスト
• すべての利用可能なリソースのリスト
• すべての利用可能なプロンプトのリスト
• 各機能タイプの統計情報

3. test_tool_call

対象のMCPサーバーで特定のツールを呼び出すテストを行います。

パラメーター：

• command (文字列)：起動コマンド
• args (配列)：コマンド引数
• env (オブジェクト、オプション)：環境変数
• test_tool (文字列)：テストするツール名
• tool_arguments (オブジェクト、オプション)：ツールに渡す引数

例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "test_tool": "echo",
  "tool_arguments": {
    "message": "Hello, MCP!"
  }
}

出力：ツール呼び出しテストレポート。以下を含みます。

• 呼び出しが成功したかどうか
• 返された内容
• エラーが発生したかどうか

テスト例

例1：シンプルなNode.js MCPサーバーをテストする

simple_server.jsという名前のMCPサーバーがあると仮定します。

1. 接続テスト：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

2. 機能テスト：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

3. ツール呼び出しテスト（サーバーに"get_time"ツールがあると仮定）：

{
  "command": "node",
  "args": ["/servers/simple_server.js"],
  "test_tool": "get_time",
  "tool_arguments": {}
}

例2：Python MCPサーバーをテストする

{
  "command": "python",
  "args": ["/servers/python_server.py"]
}

例3：uvxを介してインストールされたMCPサーバーをテストする

{
  "command": "uvx",
  "args": ["mcp-server-time"]
}

サンプルテストレポート

接続テストレポート

============================================================
🧪 MCP Server 接続テストレポート
============================================================

📋 テスト設定:
  コマンド: node
  パラメータ: server.js

🔄 テスト過程:
  🔌 対象MCP Serverに接続中...
  ✅ 接続初期化成功
  ✅ 基本接続テスト通過
  🎉 すべてのテスト手順完了

✅ テスト結果: 成功
  ステータス: connected
  メッセージ: 対象サーバーが初期化要求に正常に応答しました

============================================================

機能テストレポート

============================================================
🧪 MCP Server 能力テストレポート
============================================================

📋 テスト設定:
  コマンド: node
  パラメータ: server.js

🔄 テスト過程:
  🔌 対象MCP Serverに接続中...
  ✅ 接続初期化成功
  🔍 サーバー機能を取得中...
  📦 3つのツールを発見
  📚 0個のリソースを発見
  💬 0個のプロンプトを発見
  ✅ 機能テスト完了
  🎉 すべてのテスト手順完了

✅ テスト結果: 成功

📦 ツールリスト (3):
  1. echo
     説明: 提供されたメッセージをエコーバックする
  2. add
     説明: 2つの数値を足す
  3. get_time
     説明: 現在の時刻を取得する

📚 リソースリスト (0):
  (リソースなしまたはサポートされていない)

💬 プロンプトリスト (0):
  (プロンプトなしまたはサポートされていない)

============================================================

設定ファイル

複数のテストサーバーとテストシナリオの設定方法については、test_config_example.jsonを参照してください。

トラブルシューティング

問題：MCPエラー -32000: 接続が閉じられました

このエラーは通常、MCPクライアントがサーバーとの接続を確立できないことを意味します。

解決策：

1. オプションC（ローカルパス）を試す：

   {
     "mcpServers": {
       "mcp-tester": {
         "command": "node",
         "args": ["E:\\MCP Test\\dist\\index.js"]
       }
     }
   }
   

2. npxがパッケージを見つけられることを確認する：

   npx -y github:Peterpan-MU/MCP-Test
   

   次に、テスト用のJSON-RPCリクエストを入力します。

   {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}
   

3. Node.jsのバージョンを確認する：

   node --version  # 18.0.0以上である必要があります
   

4. npxキャッシュをクリアすることを試す：

   npx clear-npx-cache
   # または
   rm -rf ~/.npm/_npx
   

5. まずローカルにインストールする：

   npm install -g github:Peterpan-MU/MCP-Test
   

   その後、設定で"args": ["mcp-server-tester"]を使用します。

問題：接続タイムアウト (-32001)

解決策：

• 最新バージョンがインストールされていることを確認する（dist/ファイルは事前にビルドされており、コンパイルは必要ありません）
• GitHub URLでnpxを使用する場合、ネットワーク接続を確認する
• ローカルインストールオプションを試す

問題：ツール呼び出しが失敗しました

解決策：

• まずtest_server_capabilitiesを使用して利用可能なツールを表示する
• ツールのパラメーターが正しいことを確認する
• 対象サーバーのパスと依存関係を検証する

問題：インポートエラー

解決策：

cd "E:\MCP Test"
npm install
npm run build

🔧 技術詳細

• トランスポートモード：STDIO（標準入出力）
• 言語：TypeScript
• ランタイム：Node.js 18+
• MCP SDKバージョン：1.0.4+
• 並行モデル：Promiseを使用したAsync/await

プロジェクト構造

MCP-Test/
├── src/
│   ├── index.ts              # メインのMCP Testerサーバー
│   ├── tester.ts             # テストロジックの実装
│   ├── example-server.ts     # テスト用のサンプルサーバー
│   └── test.ts               # テスト実行スクリプト
├── dist/                     # コンパイルされたJavaScript（生成される）
├── package.json              # NPMパッケージの設定
├── tsconfig.json             # TypeScriptの設定
├── requirements.txt          # Pythonの依存関係（旧版）
├── README.md                 # このファイル
├── LICENSE                   # MITライセンス
├── .gitignore               # Gitの無視ルール
└── test_config_example.json # 設定例

開発

プロジェクトをビルドする

npm run build

ウォッチモード（開発用）

npm run dev

テストを実行する

npm test

npmへの公開（オプション）

このパッケージをnpmに公開して、簡単にアクセスできるようにするには：

# npmにログインする（初回のみ）
npm login

# パッケージを公開する
npm publish

公開後、ユーザーは以下を実行できます。

npx mcp-server-tester

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

コントリビューション

イシューとプルリクエストを歓迎します！

関連リソース

• MCP公式ドキュメント
• MCP TypeScript SDK
• MCPサーバーリスト

変更履歴

バージョン1.0.0 (TypeScript)

• TypeScriptで完全に書き直されました
• npxインストールがサポートされました
• 型安全性とエラーハンドリングが改善されました
• Node.jsエコシステムとの統合が向上しました

バージョン0.1.0 (Python - 旧版)

• 最初のPython実装
• 基本的なテスト機能
• STDIOモードのサポート