AIO MCP Server

AIO MCP Server

site icon
2025.04.22 0
TypeScript测试用例管理项目文件夹结构查询交流协作
jira-aio-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Jira AIO(All-in-One)测试用例管理系统进行交互。它提供了从 AIO 获取测试用例详情、按项目和/或文件夹搜索测试用例、获取项目的文件夹结构以及获取 AIO 中所有项目列表的功能。
View on GitHub

Overview

基本能力

产品定位

jira-aio-mcp-server 是一个用于与 Jira AIO 测试用例管理系统交互的 MCP 服务,旨在提供高效的测试用例管理和查询功能。

核心功能

  • 从 AIO 获取测试用例详情
  • 按项目和/或文件夹搜索测试用例
  • 获取项目的文件夹结构
  • 获取 AIO 中所有项目的列表

适用场景

  • 测试用例管理
  • 项目文件夹结构查询
  • 测试用例搜索和详情查看

工具列表

  1. get_aio_testcase:获取特定测试用例的详细信息。
  2. 参数:projectKey(项目键,如 "AT")、testCaseKey(测试用例键,如 "AT-TC-9")

  3. search_aio_testcase:在项目和特定文件夹中搜索测试用例。

  4. 参数:projectId(项目 ID,如 11502)、folderIds(可选,文件夹 ID 数组)

  5. get_aio_folders:检索项目的文件夹结构。

  6. 参数:projectId(项目 ID,如 11502)

  7. get_aio_projects:获取 AIO 中所有可用项目的列表。

  8. 无需参数

常见问题解答

  • API 请求失败:检查网络连接和 Jira 实例 URL。
  • 认证问题:确保 Jira API 令牌有效且配置正确。
  • 无效配置:检查 mcp.json 文件中的配置参数。
  • 缺少必需参数:确保所有必需参数都已提供。

使用教程

使用依赖

  • Node.js
  • 访问带有 AIO 测试用例管理系统的 Jira 实例
  • Jira API 令牌

安装教程

  1. 克隆仓库
  2. 安装依赖:
npm install
  1. 构建项目:
npm run build

配置

服务器需要通过 mcp.json 进行配置。可以将此文件放置在以下位置之一: - 主目录:~/.cursor/mcp.json - 项目根目录

示例 mcp.json 配置:

{
  "jira-aio": {
    "command": "node",
    "args": ["/path/to/aio-server-mcp/build/index.js"],
    "env": {
      "JIRA_URL": "https://your-jira-instance:port",
      "JIRA_TOKEN": "your-base64-encoded-token"
    }
  }
}

调试方式

  1. 确保 mcp.json 配置正确。
  2. 启动服务器:
node /path/to/aio-server-mcp/build/index.js
  1. 检查日志输出以确认服务器是否正常运行。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。