AIO MCP Server

AIO MCP 服务

用于与 Jira AIO（All-in-One）测试用例管理系统交互的模型上下文协议（MCP）服务。

功能

• 获取 AIO 中的测试用例详情
• 按项目和／或文件夹搜索测试用例
• 获取项目的文件夹结构
• 获取 AIO 中的所有项目列表
• 创建和更新测试用例（标题、描述、前置条件、步骤、状态、优先级）
• 创建用例时将 Jira 问题关联为需求
• 创建文件夹和子文件夹

先决条件

• Node.js 18+
• 可访问包含 AIO Tests 的 Jira 实例
• Jira API 令牌

安装

1. 克隆代码仓库
2. 安装依赖：

npm install

3. 构建项目：

npm run build

运行 npm run build 后，在 Cursor 中重启 jira-aio MCP 服务（Settings → MCP → Restart）。Cursor 不会自动重新加载 build/index.js。

配置

服务从 mcp.json 中读取 JIRA_URL 和 JIRA_TOKEN：

• ~/.cursor/mcp.json
• 或项目根目录中的 mcp.json

示例：

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

• JIRA_URL：Jira 基础 URL，如有需要，请包含端口
• JIRA_TOKEN：Jira 个人访问令牌（Bearer）

可用工具

1. get_aio_testcase

获取特定测试用例的详细信息。

• projectKey：项目键（例如 BON、MSG）
• testCaseKey：测试用例键（例如 BON-TC-170）

2. search_aio_testcase

在项目中搜索测试用例，可选指定文件夹。

• projectId：数字格式的 Jira/AIO 项目 ID（例如 11800）
• folderIds：可选的文件夹 ID 数组

3. get_aio_folders

获取项目的文件夹树。

• projectId：数字格式的项目 ID（例如 11800）

4. get_aio_projects

列出令牌可访问的 Jira 项目。

• 无参数

5. update_case

仅更新传入的字段。其他字段保持不变。响应中包含带有原值的 rollback（尤其是步骤）。

• projectKey、testCaseKey — 必填
• title
• description — 空字符串会清空此字段
• precondition — 空字符串会清空此字段
• status — Draft、Under Review、Published、Deprecated、Not integrated（ID 从项目配置中读取）
• priority — Critical、High、Medium、Low、Lowest（ID 从项目配置中读取）
• steps — 完整步骤列表：{ id?, step, expectedResult, data? }。传入 id 可更新现有步骤。若要撤销，请发送上一个响应中的 rollback.steps。

描述、前置条件和步骤中的纯文本 URL 会转换为可点击的 HTML 链接。

6. create_case

创建测试用例。步骤和 Jira 需求会在用例本身保存后保存，与 AIO 界面中的行为一致。

• projectKey、title — 必填
• folderId 或 folder — 文件夹 ID、名称或路径（例如 8616 或 не актуально / тесты）
• description、precondition
• status — 默认为 Draft
• priority
• steps — [{ step, expectedResult, data? }]
• requirements — Jira 键或 ID，例如 ["BON-1642"]

状态、优先级和自定义字段 ID 从目标项目的 AIO 配置中获取。不要将 BON ID 硬编码用于其他项目。

7. create_folder

创建文件夹或子文件夹。

• projectKey、name — 必填
• parentId 或 parent — 父文件夹 ID、名称或路径。省略则在项目根目录下创建。

备注

• 不同项目的状态和优先级 ID 不同（BON 的 Draft 为 61，MSG 的 Draft 为 49）。
• update_case 目前不会更改标签、用例类型、预估工作量或自定义字段。
• 更改代码后：运行 npm run build，然后在 Cursor 中重启 MCP jira-aio。

错误处理

服务会处理：

• API 请求失败
• 身份验证问题
• 配置无效
• 缺少必需参数

安全性

• Bearer 令牌身份验证
• 支持 HTTPS
• 令牌应放在 mcp.json／环境变量中，而非代码仓库中

开发

npm run build
npm test
npm run lint

技术栈：TypeScript、Model Context Protocol SDK、Axios。