测试管理协议服务器

Qase MCP Server是一个与测试管理平台集成的Model Context Protocol (MCP)服务器,提供测试用例的创建、获取和测试执行管理等功能。

  • by RayYokoyama
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rayyokoyama/qase-mcp-server

使用说明

Qase MCP服务器

Qase测试管理平台Model Context Protocol (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_项目

获取项目列表。

输入参数:无

使用例:

{
  "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_suite

创建测试套件。

输入参数:

  • project_code:项目代码(必需)
  • title:测试套件标题(必需)
  • description:测试套件说明(可选)
  • preconditions:测试套件先决条件(可选)
  • parent_id:父套件的ID(可选)

使用例:

{
  "name": "create_suite",
  "arguments": {
    "project_code": "DEMO",
    "title": "認証機能テストスイート",
    "description": "認証に関連する全てのテストケース",
    "preconditions": "テスト用のデータベースが初期化されていること"
  }
}

create_test_run

创建测试运行。

输入参数:

  • project_code:项目代码(必需)
  • title:测试运行的标题(必需)
  • description:测试运行说明(可选)
  • cases:测试运行中包含的测试用例的ID列表(可选)

使用例:

{
  "name": "create_test_run",
  "arguments": {
    "project_code": "DEMO",
    "title": "リグレッションテスト実行",
    "description": "v1.2.0リリース前の確認テスト",
    "cases": [1, 2, 3]
  }
}

create_test_cases_inbulk

批量创建多个测试用例。

输入参数:

  • project_code:项目代码(必需)
  • cases:要创建的测试用例数组(必需)
    • title:测试用例标题(必需)
    • description:测试用例说明(可选)
    • suite_id:所属套件的ID(可选)

使用例:

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "ログイン成功パターン",
        "description": "正しい認証情報での確認",
        "suite_id": 123
      },
      {
        "title": "ログイン失敗パターン",
        "description": "不正な認証情報での確認",
        "suite_id": 123
      }
    ]
  }
}

错误处理

每个工具都可能返回以下错误:

  • 验证错误:API标记无效或未设置
  • 参数错误:必需参数不足或值不正确
  • API错误:Qase API错误响应

错误消息包括具体的问题和处理方法。

开発

# 開発モードで実行(ファイル変更の監視)
npm run dev

# テストの実行
npm test

许可证

国际协调委员会