Qase MCP Server

🚀 Qase MCP 服務器

Qase 的測試管理平臺的 Model Context Protocol (MCP) 服務器，為用戶提供創建測試用例、獲取測試用例、管理測試執行等功能，助力高效的測試管理工作。

🚀 快速開始

Qase MCP 服務器可幫助你輕鬆管理測試用例和執行。下面將為你介紹如何安裝和配置該服務器。

📦 安裝指南

先決條件

• Node.js v23.5.0
• Qase API 令牌
• TypeScript

安裝

# 安裝依賴項
npm install

# 構建項目
npm run build

環境配置

在 MCP 的設置文件（cline_mcp_settings.json）中添加以下配置：

{
  "mcpServers": {
    "qase": {
      "command": "node",
      "args": ["path/to/qase-mcp-server/build/index.js"],
      "env": {
        "QASE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 使用示例

可用工具

get_projects

獲取項目列表。

• 輸入參數：無
• 示例：

{
  "name": "get_projects"
}

get_test_cases

獲取指定項目的測試用例列表。

• 輸入參數：
  • project_code：項目代碼（必填）
  • suite_id：套件 ID（可選）—— 獲取指定套件中的所有測試用例
• 示例：

{
  "name": "get_test_cases",
  "arguments": {
    "project_code": "DEMO",
    "suite_id": 123
  }
}

create_test_case

創建新的測試用例。

• 輸入參數：
  • project_code：項目代碼（必填）
  • title：測試用例標題（必填）
  • description：描述（可選）
• 示例：

{
  "name": "create_test_case",
  "arguments": {
    "project_code": "DEMO",
    "title": "登錄成功場景",
    "description": "使用有效憑證進行驗證"
  }
}

create_test_cases_in_bulk

批量創建多個測試用例。

• 輸入參數：
  • project_code：項目代碼（必填）
  • cases：測試用例數組（每個對象包含 title 和可選的 description）
• 示例：

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "登錄成功場景",
        "description": "使用有效憑證進行驗證"
      },
      {
        "title": "登錄失敗場景",
        "description": "使用無效憑證進行驗證"
      }
    ]
  }
}

🔧 技術細節

錯誤處理

各個工具可能遇到以下錯誤：

• 認證錯誤：API 令牌無效或未設置
• 參數錯誤：必填參數缺失或值不正確
• API 錯誤：Qase API 返回的錯誤響應

錯誤消息會包含具體的問題和解決方法。

開發指南

# 以開發模式運行（監控文件變化）
npm run dev

# 執行測試
npm test

📄 許可證

ISC