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