MeterSphere MCP Server (模型上下文协议)

该项目基于模型上下文协议（MCP）规范实现了一个用于API测试的MCP服务器，允许LLM客户端（如VS Code、Claude、cursor等）通过标准化协议调用测试服务，获取接口定义，执行测试用例并返回结果。

简介

MeterSphere MCP Server（模型上下文协议服务器）通过HTTP+SSE、STDIO或Docker通道与MCP客户端建立连接，向LLM暴露测试相关的工具和资源。作为测试平台与开发环境之间的智能桥梁，它完全打破了测试与开发之间的壁垒，使开发者能够在IDE、代码编辑器或AI助手中直接访问、执行和分析测试资源，无需切换工具。开发者可以使用自然语言指令让大型模型调用底层测试能力，实现接口测试、文档检索、模拟服务创建、兼容性验证等全流程操作，将测试前移至开发阶段，显著缩短反馈循环，提高研发效率。同时，测试团队配置的测试资产（如案例库、环境配置、断言规则等）可以无缝被开发者调用，确保统一的测试标准，并推动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_TYPE（http-sse | stdio | docker）
• AK/SK(认证密钥)
• MeterSphereURL(已部署的MeterSphere平台地址)

安全与权限

• 支持AK/SK认证。
• 管理角色权限，仅允许授权角色调用敏感工具（如“项目数据获取与处理”）。