AIO Tests MCP Server

Открытый MCP-сервер для 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 выше станет доступна с первым релизом. А пока используйте Запуск из исходников — это займёт две команды.

Зачем это существует. Официальный MCP-сервер AIO Tests — это закрытый, удалённо размещённый сервис с URL, специфичным для тенанта, и поддержкой только Cloud. Этот же сервер можно размещать самостоятельно и проверять — вы можете прочитать каждую строку, форкнуть его и запустить в своей собственной сети. Насколько мне известно, это единственный MCP-сервер AIO Tests, поддерживающий Jira Server / Data Center, и у него есть режим только для чтения, так что вы можете безопасно направить ИИ на производственный экземпляр.

Инструменты

Десять инструментов, все привязаны к проекту Jira.

Поля поиска принимают имена или ID. Вы можете сказать "Critical" вместо 4 или /Regression/Checkout вместо ID папки — значения разрешаются на основе конфигурации проекта, поэтому модель работает в том же словаре, который вы видите в интерфейсе AIO Tests.

Обновления сохраняют форматирование. Обновления кейсов проходят полный цикл документа с включённым форматированным текстом, поэтому форматирование полей, которые вы не трогали, сохраняется, а ввод обычного текста экранируется для соответствия.

Related MCP server: MCP Zephyr Scale Cloud Server

Быстрый старт

1. Получите токен доступа

Jira Cloud — в Jira откройте AIO Tests → значок (?) → API Access Token и сгенерируйте токен. Токен идентифицирует ваш тенант, поэтому URL не нужен.

Jira Server/Data Center — API AIO Tests обслуживается с вашего базового URL Jira и использует ваши учётные данные 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/mcp.json для Cursor, .vscode/mcp.json для VS Code). Cursor также принимает локальный для проекта mcp.json.

В Claude Code вы можете добавить его одной командой:

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

3. Попросите что-нибудь

«Найди в PROJ опубликованные тест-кейсы с тегом smoke в /Regression/Checkout и покажи шаги первого из них.»

«Прочитай PROJ-142 и напиши BDD-тест-кейсы, покрывающие критерии приёмки.»

Конфигурация

Каждый параметр — это переменная окружения; полный список см. в .env.example. Основные:

Параметры прокси (AIO_HTTP_PROXY, AIO_HTTPS_PROXY, AIO_SOCKS_PROXY, AIO_NO_PROXY), клиентские сертификаты и пользовательские заголовки также поддерживаются.

Те же параметры доступны в виде флагов CLI:

uvx aio-tests-mcp-server --help

Режим только для чтения

Направляете ИИ на производственную 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

Ограничения

• Переименование, перемещение и удаление папок не реализованы. Публичный API AIO Tests не предоставляет для них конечной точки.

• Тестовые циклы и тестовые прогоны пока не поддерживаются. Текущий набор инструментов ограничен управлением тест-кейсами — кейсы, папки, теги и схема проекта. Приветствуются вклады.

Часто задаваемые вопросы

Это официальный MCP-сервер AIO Tests? Нет. AIO Tests публикует свой собственный MCP-сервер как размещённый сервис — с закрытым исходным кодом, с URL, специфичным для тенанта, и только для Cloud. Это независимая реализация с открытым исходным кодом, которую вы запускаете сами. Она не связана с AIO Tests или Atlassian и не одобрена ими.

Работает ли он с Jira Data Center или Jira Server? Да. Установите AIO_ENABLED=true и JIRA_URL и аутентифицируйтесь с помощью персонального токена доступа Jira или имени пользователя и пароля. На Server/DC API AIO Tests обслуживается с вашего базового URL Jira, поэтому он использует ваши учётные данные Jira. Это основная причина выбрать этот сервер вместо альтернатив — размещённые поддерживают только Cloud.

Могу ли я использовать его с Claude Code, Claude Desktop, Cursor или VS Code? Да — работает любой MCP-клиент. См. Добавьте его в ваш MCP-клиент для готовой конфигурации.

Безопасно ли направлять его на производственную Jira? Запустите его с --read-only (или READ_ONLY_MODE=true). Инструменты записи затем полностью отфильтровываются из списка инструментов, так что модель никогда не видит, что создание или обновление возможно.

Куда попадают мои учётные данные? Никуда, кроме вашей собственной машины и вашего экземпляра Jira. Сервер по умолчанию работает локально через stdio и напрямую общается с REST API AIO Tests. Никакого промежуточного сервиса нет.

Может ли один экземпляр сервера обслуживать всю команду? Да — запустите его через HTTP и пусть каждый клиент отправляет свой собственный токен в заголовке X-Aio-Api-Token. См. Мультитенантное использование.

Поддерживает ли он тестовые циклы, выполнения или вложения? Пока нет. Текущий набор инструментов охватывает управление тест-кейсами — кейсы, папки, теги и схему проекта. Циклы и выполнения — очевидный следующий шаг; см. Ограничения, и приветствуются сообщения о проблемах.

Участие в разработке

Приветствуются сообщения о проблемах и pull request'ы — см. CONTRIBUTING.md. Тестовый набор покрывает клиент, разрешение конфигурации, каждый миксин и каждый инструмент; пожалуйста, поддерживайте его зелёным и добавляйте тесты для нового поведения.

Лицензия

MIT.

Части этого проекта основаны на mcp-atlassian от @sooperset, также распространяется по лицензии MIT. Спасибо за основу.

Этот проект не связан с AIO Tests или Atlassian и не одобрен ими.