MeterSphere MCP Server (Model Context Protocol)

MeterSphere MCP Server（Model Context Protocol）

本プロジェクトは、Model Context Protocol（MCP）仕様に基づいて、API テスト向けの MCP サーバーを実装しています。VS Code、Claude、Cursor などの LLM クライアントが、標準化されたプロトコルを通じてテストサービスを呼び出し、インターフェース定義を取得し、テストケースを実行して結果を返せるようにします。

概要

MeterSphere MCP Server（Model Context Protocol Server）は、HTTP + SSE、STDIO、または Docker チャネルを通じて MCP クライアントと接続し、テスト関連のツールとリソースを LLM に公開します。テストプラットフォームと開発環境をつなぐインテリジェントな橋渡し役として、テストと開発の間の壁を取り払い、開発者がツールを切り替えることなく、IDE、コードエディター、AI アシスタントからテストリソースを直接取得、実行、分析できるようにします。開発者は自然言語の指示で LLM に基盤となるテスト機能を呼び出させ、インターフェーステスト、ドキュメントの取得、Mock サービスの作成、互換性検証などの一連の操作を実現できます。これによりテストを開発段階へ前倒しし、フィードバックサイクルを大幅に短縮して、開発効率を高めます。また、テストチームが設定したテスト資産（ケースライブラリ、環境設定、アサーションルールなど）を開発者がシームレスに呼び出せるため、テスト標準の統一を確保し、DevTestOps の一体化を促進します。クライアントはツールを検出して呼び出し、機能テスト、インターフェーステスト、インターフェースドキュメントの取得など、さまざまなシナリオを実行できます。これにより、テストプロセスのインテリジェント化、自動化、協調化を実現します。

インストールと実行

git clone https://github.com/metersphere/metersphere-mcp-server.git
cd metersphere-mcp-server
mvn clean install

主な機能

クライアントの設定例

VS Code

// .vscode/settings.json

{
  "servers": {
    // SSE 连接方式配置
    "ms-mcp-server-sse": {
      "type": "sse",
      "url": "http://localhost:8000/sse",
      "headers": {
        "accessKey": "your-access-key",
        "signature": "your-signature",
        "meterSphereUrl": "http://your-metersphere-url"
      }
    },
    
    // Docker 连接方式配置
    "ms-mcp-server-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "-p", 
        "8000:8000", 
        "-e", "accessKey=${env:accessKey}",
        "-e", "signature=${env:signature}",
        "-e", "meterSphereUrl=${env:meterSphereUrl}",
        "metersphere-mcp-server"
      ],
      "env": {
        "accessKey": "your-access-key", 
        "signature": "your-signature",
        "meterSphereUrl": "http://your-metersphere-url"
      }
    }
  }
}

Claude クライアント

{
  "mcp_providers": {
    // SSE 方式连接
    "metersphere-sse": {
      "protocol": {
        "type": "sse",
        "baseUrl": "http://localhost:8000",
        "path": "/sse"
      },
      "auth": {
        "type": "header",
        "headers": {
          "accessKey": "your-access-key",
          "signature": "your-signature",
          "meterSphereUrl": "http://your-metersphere-url"
        }
      },
      "defaults": {
        "env": "dev"
      }
    },

    // Docker 方式连接
    "metersphere-docker": {
      "protocol": {
        "type": "stdio",
        "command": "docker run -i --rm -p 8000:8000 metersphere-mcp-server"
      },
      "env": {
        "accessKey": "your-access-key",
        "signature": "your-signature",
        "meterSphereUrl": "http://your-metersphere-url"
      },
      "defaults": {
        "env": "staging"
      }
    }
  },

  // 默认使用提供者
  "default_provider": "metersphere-sse"
}

設定とデプロイ

• PORT（HTTP ポート、デフォルトは 8000）
• MCP_TPYE（http-sse | stdio | docker）
• AK/SK（認証キー）
• MeterSphereURL（デプロイされた MeterSphere プラットフォームのアドレス）

セキュリティと権限

• AK/SK 認証に対応しています。
• 管理者ロールの権限を管理し、承認されたロールのみが機密性の高いツール（プロジェクトデータ取得と処理 など）を呼び出せるようにします。