TestRail MCP 서버

표준화된 프로토콜을 통해 TestRail의 핵심 엔터티와 상호 작용할 수 있는 TestRail용 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• TestRail API를 통한 인증
• TestRail 엔터티에 대한 액세스:
  • 프로젝트
  • 사례
  • 실행
  • 결과
  • 데이터 세트
• 모델 컨텍스트 프로토콜에 대한 전체 지원
• 모든 MCP 클라이언트(Claude Desktop, Cursor, Winsurf 등)와 호환됩니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 testrail-mcp를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 이 저장소를 복제하세요:
   git clone https://github.com/yourusername/testrail-mcp.git cd testrail-mcp
2. 가상 환경을 만들고 활성화하세요.
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 종속성 설치:
   pip install -e .

구성

TestRail MCP 서버는 TestRail 인스턴스 인증을 위해 특정 환경 변수를 필요로 합니다. 이러한 변수는 서버를 실행하기 전에 설정해야 합니다.

1. 프로젝트의 루트 디렉토리에 .env 파일을 만듭니다.
   TESTRAIL_URL=https://your-instance.testrail.io TESTRAIL_USERNAME=your-email@example.com TESTRAIL_API_KEY=your-api-key
   중요 참고 사항:
   • TESTRAIL_URL TestRail 인스턴스의 전체 URL이어야 합니다(예: https://example.testrail.io ).
   • TESTRAIL_USERNAME 은 로그인에 사용되는 TestRail 이메일 주소입니다.
   • TESTRAIL_API_KEY 는 TestRail API 키입니다(비밀번호가 아님).
     • API 키를 생성하려면 TestRail에 로그인하고 "내 설정" > "API 키"로 이동하여 새 키를 생성하세요.
2. 구성이 올바르게 로드되었는지 확인하세요.
   python -c "from testrail_mcp.config import TESTRAIL_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY; print(f'URL: {TESTRAIL_URL}, Username: {TESTRAIL_USERNAME}, API Key: {TESTRAIL_API_KEY[:5]}...')"
   이렇게 하면 TestRail URL, 사용자 이름, API 키의 처음 몇 글자가 출력됩니다.

Claude Desktop이나 Cursor와 같은 클라이언트와 함께 이 서버를 사용하는 경우, 서버를 실행하는 프로세스에서 환경 변수에 접근할 수 있는지 확인하세요. 이러한 변수를 시스템 환경에 설정하거나 .env 파일에서 로드해야 할 수도 있습니다.

용법

서버 실행

서버는 Python 모듈로 직접 실행할 수 있습니다.

이렇게 하면 MCP 서버가 stdio 모드로 시작되며, stdio 통신을 지원하는 MCP 클라이언트와 함께 사용할 수 있습니다.

MCP 클라이언트와 함께 사용

클로드 데스크탑

1. 클로드 데스크톱 열기
2. 설정 > 서버로 이동하세요
3. "서버 설치"를 클릭하세요
4. 프로젝트 디렉토리로 이동하세요
5. Python 모듈을 선택하세요: testrail_mcp
6. 이제 Claude Desktop에서 TestRail MCP 서버를 사용할 수 있습니다.

커서

1. 커서 열기
2. 설정 > AI > 사용자 정의 도구로 이동하세요.
3. "도구 추가"를 클릭하세요
4. 도구 구성:
   • 이름: TestRail MCP
   • 명령어: python -m testrail_mcp
   • 커뮤니케이션: Stdio
5. 구성을 저장합니다

윈서프

1. 윈서프 오픈
2. 설정 > 도구로 이동하세요
3. "도구 추가"를 클릭하세요
4. 도구 구성:
   • 이름: TestRail MCP
   • 명령어: python -m testrail_mcp
   • 프로토콜: MCP
5. 구성을 저장합니다

MCP Inspector로 테스트

테스트 및 디버깅을 위해 MCP Inspector를 사용할 수 있습니다.

이렇게 하면 사용 가능한 모든 도구와 리소스를 탐색하고 테스트할 수 있는 웹 인터페이스가 열립니다.

개발

이 서버는 다음을 사용하여 구축되었습니다.

• FastMCP - MCP 서버 구축을 위한 Python 프레임워크
• 요청 - TestRail API와의 HTTP 통신을 위한
• python-dotenv - 환경 변수 관리용

특허

MIT