MCP Xray

mcp x射线

MCP服务器使用TypeScript 5与Xray Cloud和Xray Data Center交互。

安装

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

使用

编译后，运行MCP服务器：

node dist/index.js

服务器根据MCP协议通过STDIO（STDIN/STDOUT）进行通信，因此需要由兼容的MCP客户端调用。

政府职能

• 部署支持 cloud y datacenter
• xray云身份验证使用 client_id y client_secret
• 用于测试执行和测试计划操作的JIRA认证
• 用于验证与Xray/JIRA连接的MCP工具
• 在Xray Cloud上运行GraphQL查询的MCP工具
• 将运行结果导入xray的MCP工具
• 用于搜索、查询和创建测试执行的MCP工具
• 用于搜索、查询和创建测试计划的MCP工具
• 面向可测试性的模块化体系结构
• 具有自动覆盖的测试套件

环境变量

云

XRAY_DEPLOYMENT=cloud
XRAY_CLIENT_ID=your-client-id
XRAY_CLIENT_SECRET=your-client-secret
XRAY_BASE_URL=https://xray.cloud.getxray.app
XRAY_TOKEN_TTL_SECONDS=3000
JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_EMAIL=you@example.com
JIRA_API_TOKEN=your-jira-api-token

数据中心

XRAY_DEPLOYMENT=datacenter
JIRA_BASE_URL=https://jira.example.com
JIRA_PAT=your-personal-access-token
# Alternativa:
# JIRA_USERNAME=your-user
# JIRA_PASSWORD=your-password
XRAY_BASE_URL=https://jira.example.com
XRAY_TOKEN_TTL_SECONDS=3000

与VSCode的集成

要在VSCode中与GitHub Copilot一起使用此MCP服务器，请将以下设置添加到您的MCP设置文件中：

Windows/Linux： %APPDATA%\Code\User\globalStorage\github.copilot-chat\mcp.json\ macOS： ~/Library/Application Support/Code/User/globalStorage/github.copilot-chat/mcp.json

{
  "mcpServers": {
    "xray": {
      "command": "node",
      "args": [
        "/ruta/absoluta/a/mcp-xray/dist/index.js"
      ],
      "env": {
        "XRAY_DEPLOYMENT": "cloud",
        "XRAY_CLIENT_ID": "tu-client-id",
        "XRAY_CLIENT_SECRET": "tu-client-secret",
        "XRAY_BASE_URL": "https://xray.cloud.getxray.app",
        "XRAY_TOKEN_TTL_SECONDS": "3000",
        "JIRA_BASE_URL": "https://tu-dominio.atlassian.net",
        "JIRA_EMAIL": "tu@email.com",
        "JIRA_API_TOKEN": "tu-jira-api-token"
      }
    }
  }
}

根据部署类型（云或数据中心）调整环境变量。配置后，重新启动VSCode，MCP服务器将可用于GitHub Copilot。

脚本

npm run dev
npm run build
npm test

注释

• xray_graphql 这是为云设计的。
• 关于测试执行和测试计划的操作得到了JIRA REST的支持，因为这些实体在JIRA/xray中以问题的形式存在。
• 对于数据中心，导入使用以下xray服务器/数据中心的经典路径 /rest/raven/1.0.