JinDaGe - jira-aio-mcp-server MCP Details

article

README

🚀 AIO MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

克隆仓库
安装依赖项：

npm install

构建项目：

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"
    }
  }
}

配置参数

| 属性 | 详情 | |------|------| | JIRA_URL | 你的 Jira 实例的 URL（包括端口如果有必要） | | JIRA_TOKEN | 你在 Jira 中用于身份验证的 API 令牌 |

可用工具

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 请求

jira-aio-mcp-server