AIO Tests MCP Server

一个开源的 MCP server，用于 AIO Tests —— Jira 的测试管理工具。

将 Claude、Claude Code、Cursor、VS Code、Windsurf 或任何其他 MCP 客户端连接到你的 Jira 测试用例。搜索并读取它们，查看项目的字段架构，浏览文件夹树，并以自然对话创建或更新用例 —— 包括 Classic 和 BDD 两种格式。

支持 Jira Cloud 和 Jira Server / Data Center。自托管，因此你的凭据和测试数据永远不会离开你的基础设施。

uvx aio-tests-mcp-server

尚未发布到 PyPI。 上面的 uvx 命令将在首次发布时生效。 在此之前，请使用从源码运行 —— 只需两条命令。

为什么存在这个项目。 官方的 AIO Tests MCP 服务器是一个闭源、远程托管的服务，具有特定于租户的 URL，且仅支持 Cloud。这个项目是可自托管、可审计的 —— 你可以阅读每一行代码、fork 它，并在自己的网络内运行。据我所知，这是唯一支持 Jira Server / Data Center 的 AIO Tests MCP 服务器，并且它具有只读模式，因此你可以安全地将 AI 指向生产实例。

工具

十个工具，全部限定在 Jira 项目范围内。

查找字段接受名称或 ID。 你可以说 "Critical" 而不是 4，或者 /Regression/Checkout 而不是文件夹 ID —— 值会根据项目配置进行解析，因此模型使用与你在 AIO Tests UI 中看到的相同词汇。

更新保留格式。 用例更新会在启用富文本的情况下往返文档，因此你未触碰的字段格式得以保留，纯文本输入也会被转义以匹配。

Related MCP server: jira-aio-mcp-server

快速开始

1. 获取访问令牌

Jira Cloud —— 在 Jira 中，打开 AIO Tests → (?) 图标 → API Access Token 并生成一个。该令牌标识你的租户，因此无需 URL。

Jira Server/Data Center —— AIO Tests API 从你的 Jira 基础 URL 提供服务，并复用你的 Jira 凭据（个人访问令牌，或用户名 + 密码）。

2. 将其添加到你的 MCP 客户端

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_API_TOKEN": "your_aio_access_token"
      }
    }
  }
}

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_ENABLED": "true",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_access_token"
      }
    }
  }
}

与上面相同的 JSON，放在客户端的 MCP 设置文件中（Cursor 使用 ~/.cursor/mcp.json，VS Code 使用 .vscode/mcp.json）。Cursor 也接受项目本地的 mcp.json。

在 Claude Code 中，你可以用一条命令添加：

claude mcp add aio-tests --env AIO_API_TOKEN=your_token -- uvx aio-tests-mcp-server

3. 提出请求

"在 PROJ 中搜索 /Regression/Checkout 下标记为 smoke 的已发布测试用例，并显示第一个用例的步骤。"

"读取 PROJ-142 并编写覆盖验收标准的 BDD 测试用例。"

配置

每个设置都是一个环境变量；完整列表请参阅 .env.example。基本项：

也支持代理设置（AIO_HTTP_PROXY、AIO_HTTPS_PROXY、AIO_SOCKS_PROXY、AIO_NO_PROXY）、客户端证书和自定义标头。

相同的选项也可作为 CLI 标志使用：

uvx aio-tests-mcp-server --help

只读模式

将 AI 指向生产 Jira 时，你可能希望它只查看而不修改：

uvx aio-tests-mcp-server --read-only

写入工具随后会从工具列表中完全隐藏，因此模型永远不会看到它们。

HTTP 传输

对于共享或容器化部署，可以通过 Streamable HTTP 而不是 stdio 运行：

uvx aio-tests-mcp-server --transport streamable-http --port 8000

服务器暴露 /mcp 和 /healthz 端点，用于 Kubernetes 探针。

多租户使用

一个服务器实例可以为多个用户提供服务。每个客户端在每个请求中发送自己的 AIO Tests 令牌，请求将限定在该租户范围内：

{
  "mcpServers": {
    "aio-tests": {
      "url": "https://aio-mcp.your-company.com/mcp",
      "headers": {
        "X-Aio-Api-Token": "the_users_own_token"
      }
    }
  }
}

Authorization: Token <token> 可作为 X-Aio-Api-Token 标头的等效方式。

从源码运行

git clone https://github.com/AmirhosseinHanifehzadeh/aio-tests-mcp.git
cd aio-tests-mcp
uv sync
cp .env.example .env   # then fill it in
uv run aio-tests-mcp-server

运行测试：

uv run pytest

限制

• 文件夹重命名、移动和删除尚未实现。 AIO Tests 公共 API 没有提供相应的端点。

• 测试周期和测试运行尚未覆盖。 当前工具集限定在测试用例管理 —— 用例、文件夹、标签和项目架构。欢迎贡献。

常见问题

这是官方的 AIO Tests MCP 服务器吗？ 不是。AIO Tests 发布了自己的 MCP 服务器作为托管服务 —— 闭源，具有特定于租户的 URL，且仅支持 Cloud。这是一个独立的开源实现，由你自己运行。它与 AIO Tests 或 Atlassian 没有关联，也未获得其认可。

它支持 Jira Data Center 或 Jira Server 吗？ 支持。设置 AIO_ENABLED=true 和 JIRA_URL，并使用 Jira 个人访问令牌或用户名和密码进行身份验证。在 Server/DC 上，AIO Tests API 从你的 Jira 基础 URL 提供服务，因此它复用你的 Jira 凭据。这是选择此服务器而非其他方案的主要原因 —— 托管的方案仅支持 Cloud。

我可以将其与 Claude Code、Claude Desktop、Cursor 或 VS Code 一起使用吗？ 可以 —— 任何 MCP 客户端都可以。请参阅将其添加到你的 MCP 客户端获取可直接粘贴的配置。

将其指向生产 Jira 安全吗？ 使用 --read-only（或 READ_ONLY_MODE=true）运行。写入工具随后会从工具列表中完全过滤掉，因此模型永远不会看到创建或更新是一个选项。

我的凭据会去哪里？ 除了你自己的机器和你的 Jira 实例，哪里都不会去。服务器默认在本地通过 stdio 运行，并直接与 AIO Tests REST API 通信。没有中间服务。

一个服务器实例可以为整个团队提供服务吗？ 可以 —— 通过 HTTP 运行它，并让每个客户端在 X-Aio-Api-Token 标头中发送自己的令牌。请参阅多租户使用。

它支持测试周期、执行或附件吗？ 目前不支持。当前工具集涵盖测试用例管理 —— 用例、文件夹、标签和项目架构。周期和执行是明显的下一步；请参阅限制，欢迎提交 issue。

贡献

欢迎提交 issue 和 pull request —— 请参阅 CONTRIBUTING.md。测试套件覆盖客户端、配置解析、每个 mixin 和每个工具；请保持测试通过，并为新行为添加测试用例。

许可证

MIT。

本项目的部分内容衍生自 mcp-atlassian，作者为 @sooperset，同样采用 MIT 许可证。感谢这个基础。

本项目与 AIO Tests 或 Atlassian 没有关联，也未获得其认可。