MCP Server Tester Po4

MCPサーバーテストツールは、AIモデルと統合されたMCPサーバーの検証、ベンチマークテスト、および信頼性の確保を行う設定駆動型のテストソリューションです。自動ツール検出、スマートテストケース生成、検証の実行、および詳細なレポートの生成をサポートしています。

開発者ツール人工知能チャットボット #AIテスト #プロトコル検証 #自動化テスト #設定駆動 .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 5.2K

更新時間 : 2025-04-23

サイトを開く

インストール

以下のコマンドをクライアントにコピーして設定

{
  "numTestsPerTool": 3,
  "timeoutMs": 10000,
  "outputFormat": "console",
  "outputPath": "./reports/results.json",
  "verbose": false,
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"],
      "env": {
        "DEBUG": "true"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token-here"
      }
    },
    "dev-server": {
      "command": "node",
      "args": ["/absolute/path/to/your/dev-server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

{
  "servers": ["filesystem", "dev-server"],
  "numTestsPerTool": 3,
  // other settings...
  "mcpServers": {
    // server definitions...
  }
}

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 MCP サーバーテスタードキュメント

MCP サーバーテスターは、MCP プロトコルをサポートするサーバーをテストするためのツールです。このツールは MCP サーバーに接続し、利用可能なツールを発見し、サーバーの動作を検証するための自動化テストを実行します。

🚀 クイックスタート

基本設定

デフォルトの設定ファイルを作成する：
```
mcp-server-tester --init
```
mcp-servers.json ファイルを編集する：自分のサーバーと設定を追加します。
.env ファイルを作成する：あなたの Anthropic API キーを含めます。
```
echo "ANTHROPIC_API_KEY=your-api-key-here" > .env
```
テストを実行する：
```
mcp-server-tester
```

開発バージョンのテスト

mcp-servers.json に開発サーバーの設定を追加します。

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

そして、テストを実行します。

mcp-server-tester

複数の設定ファイルでのテスト

異なる環境に対応するために、異なる設定ファイルを作成します。

cp mcp-servers.json config-dev.json
cp mcp-servers.json config-prod.json

各ファイルを編集して適切な設定を行い、次のコマンドを実行します。

mcp-server-tester ./config-dev.json
mcp-server-tester ./config-prod.json

📦 インストール

# 依存関係のインストール
npm install

💻 使用例

基本的な使用法

# テスターを実行する
node src/server.js

高度な使用法

# 異なる設定で実行する
node src/server.js --config config-dev.json

📚 ドキュメント

設定オプション

サーバー設定

mcp-servers.json でサーバーを定義します。

{
  "mcpServers": {
    "server1": {
      "command": "node",
      "args": ["index.js"],
      "env": {}
    }
  }
}

テスト設定

設定ファイル内のテストオプションは以下の通りです。

属性	詳情
`numWorkers`	並列実行するワーカーの数（デフォルト：4）
`timeoutMs`	各ツールの実行最大時間（ミリ秒、デフォルト：1000）
`outputFormat`	レポート形式（サポート：`console`、`json`、`html`、デフォルト：`console`）
`outputPath`	出力ファイルのパス（デフォルト：`./test-results.json` または `stdout`）

テストフロー

接続と発見

サーバーに接続する：テスターは TCP プロトコルを使用して MCP サーバーに接続します。
ツールを発見する：RPC リクエストを通じて、サーバーがサポートするツールのリストを取得します。

実行と検証

各ツールに対して、テスターは以下の操作を行います。

RPC リクエストを送信する。
応答を待つ。
結果が予想通りかどうかを検証する。

レポート形式

コンソール出力（デフォルト）

テスト結果を直接ターミナルに表示します。

JSON レポート

構造化された JSON ファイルを生成します。パスは outputPath で指定します。

HTML レポート

可視化インターフェースを含む HTML ファイルを生成し、分析や閲覧を容易にします。

トラブルシューティング

接続問題

サーバー設定が正しいことを確認してください。
サーバーが MCP プロトコルをサポートしていることを検証してください。
遅いサーバーに対応するために、timeoutMs を増やしてください。
詳細なログ記録を有効にするには、verbose: true を設定してください。

API キーの問題

API キーが有効で正しいことを確認してください。
.env ファイルがプロジェクトのルートディレクトリにあることを確認してください。
キーに空白や余分な文字がないことを検証してください。

ツールの実行失敗

サーバーが MCP プロトコルを正しく実装していることを確認してください。
サーバーログを確認してエラー情報を取得してください。
ツールのパラメータ設定が正しいことを確認してください。

プロジェクト構造

mcp-server-tester/
├── package.json          # プロジェクトの依存関係とスクリプト
├── src/                 # ソースコードディレクトリ
│   ├── server.js        # テスターのメインプログラム
│   └── worker.js        # 並列実行のワーカー
├── mcp-servers.json      # サーバー設定ファイル
└── .env                 # 環境変数ファイル