AIO Tests MCP 서버

Jira용 테스트 관리 도구인 AIO Tests를 위한 오픈소스 MCP 서버입니다.

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 전용 지원을 제공합니다. 이 서버는 자체 호스팅이 가능하고 감사 가능합니다 — 모든 코드를 읽고, 포크하고, 자체 네트워크 내에서 실행할 수 있습니다. 제가 아는 한, Jira Server / Data Center를 지원하는 유일한 AIO Tests MCP 서버이며, 읽기 전용 모드가 있어 프로덕션 인스턴스에 AI를 안전하게 연결할 수 있습니다.

도구

모두 Jira 프로젝트 범위로 제한된 10개의 도구입니다.

조회 필드는 이름 또는 ID를 허용합니다. 4 대신 "Critical"이라고 하거나 폴더 ID 대신 /Regression/Checkout이라고 할 수 있습니다 — 값은 프로젝트 구성에 대해 확인되므로 모델은 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"
      }
    }
  }
}

클라이언트의 MCP 설정 파일에 위와 동일한 JSON을 넣습니다(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

읽기 전용 모드

프로덕션 Jira에 AI를 연결한다면 보기만 하고 건드리지 않게 하고 싶을 것입니다:

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

쓰기 도구는 도구 목록에서 완전히 숨겨지므로 모델이 해당 도구를 볼 수 없습니다.

HTTP 전송

공유 또는 컨테이너화된 배포의 경우 stdio 대신 Streamable HTTP로 실행하세요:

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

서버는 /mcp와 Kubernetes 프로브용 /healthz 엔드포인트를 노출합니다.

멀티 테넌트 사용

하나의 서버 인스턴스가 여러 사용자에게 서비스를 제공할 수 있습니다. 각 클라이언트는 요청별로 자체 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에는 이에 대한 엔드포인트가 없습니다.

• 테스트 사이클 및 테스트 실행은 아직 다루지 않습니다. 현재 도구 세트는 테스트 케이스 관리 — 케이스, 폴더, 태그 및 프로젝트 스키마 — 로 범위가 제한됩니다. 기여를 환영합니다.

FAQ

이것이 공식 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 헤더에 자체 토큰을 보내게 하세요. 멀티 테넌트 사용을 참조하세요.

테스트 사이클, 실행 또는 첨부 파일을 지원하나요? 아직은 아닙니다. 현재 도구 세트는 테스트 케이스 관리 — 케이스, 폴더, 태그 및 프로젝트 스키마 — 를 다룹니다. 사이클과 실행이 다음 단계로 명확합니다. 제한 사항을 참조하세요. 이슈 제출을 환영합니다.

기여

이슈와 풀 리퀘스트를 환영합니다 — CONTRIBUTING.md를 참조하세요. 테스트 스위트는 클라이언트, 구성 해석, 모든 믹스인 및 모든 도구를 다룹니다. 테스트를 통과 상태로 유지하고 새 동작에 대한 테스트 케이스를 추가해 주세요.

라이선스

MIT.

이 프로젝트의 일부는 @sooperset의 mcp-atlassian에서 파생되었으며, 역시 MIT 라이선스입니다. 기반을 마련해 주셔서 감사합니다.

이 프로젝트는 AIO Tests 또는 Atlassian과 제휴하거나 보증하지 않습니다.