Jira Aio MCP Server

🚀 AIO MCP 服务器

AIO MCP 服务器是一个用于与 Jira AIO（All-in-One）测试用例管理系统交互的模型上下文协议（MCP）服务器。它能够帮助用户获取测试用例详细信息、搜索测试用例、获取项目文件夹结构以及项目列表等。

🚀 快速开始

AIO MCP 服务器可与 Jira AIO 测试用例管理系统进行交互，为你提供测试用例的详细信息、搜索功能等。

✨ 主要特性

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

📦 安装指南

先决条件

• Node.js
• 对 Jira 实例的访问权限，该实例安装了 AIO 测试用例管理系统
• Jira API 令牌

安装步骤

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

npm install

3. 构建项目：

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. get_aio_testcase

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

• 参数：
  • projectKey：AIO 中的项目密钥（例如，“AT”）
  • testCaseKey：测试用例密钥（例如，“AT-TC-9”）

2. search_aio_testcase

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

• 参数：
  • projectId：AIO 中的项目 ID（例如，11502）
  • folderIds：（可选）要在此范围内搜索的文件夹 ID 数组

3. get_aio_folders

获取项目的文件夹结构。

• 参数：
  • projectId：AIO 中的项目 ID（例如，11502）

4. get_aio_projects

获取 AIO 中所有可用项目的列表。

• 无参数要求

错误处理

服务器包含全面的错误处理功能，包括：

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

安全性

• 服务器使用带有 bearer token 的身份验证
• 支持 HTTPS 连接
• 敏感配置可通过环境变量提供

开发

该服务器使用以下技术构建：

• TypeScript
• 模型上下文协议 SDK
• Axios 用于 HTTP 请求