파이썬 지라 MCP 서버

Jira API와 통합되는 Python 기반 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이를 통해 AI 모델은 표준화된 프로토콜을 통해 Jira와 상호 작용할 수 있습니다.

개요

이 MCP 서버는 모델 컨텍스트 프로토콜(Model Context Protocol)을 지원하는 AI 모델에서 사용할 수 있는 도구로서 Jira API 작업을 제공합니다. 이 서버는 커서(Cursor)와 같은 클라이언트와 통신하기 위해 stdio 전송 메커니즘을 구현합니다.

Related MCP server: Jira MCP Server

특징

• JQL 검색 도구 : JQL 쿼리를 사용하여 Jira 문제 검색

• 문제 가져오기 도구 : 특정 Jira 문제에 대한 자세한 정보 검색

• MCP SDK 통합 : 공식 MCP Python SDK와 호환

• 폴백 모드 : SDK를 사용할 수 없는 경우 최소 구현

• 환경 구성 : 환경 변수에서 Jira 자격 증명 로드

요구 사항

• 파이썬 3.8 이상

• Jira API 액세스(API 토큰, 이메일 및 도메인)

• 필요한 Python 패키지:

  • mcp (모델 컨텍스트 프로토콜 Python SDK)

  • aiohttp (HTTP 요청용)

  • pydantic (검증용)

  • python-dotenv (환경 변수용)

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 종속성을 설치합니다.

   pip install -r requirements.txt

3. Jira 자격 증명을 설정하세요.

   cp .env.example .env # Edit .env with your Jira credentials

용법

서버 실행

MCP 서버를 시작하려면 다음을 실행하세요.

또는 실행 파일을 직접 사용하세요.

서버는 시작되어 표준 입력(stdin)에서 MCP 메시지를 수신하고 표준 출력(stdout)에서 응답합니다.

커서와 통합

커서와 함께 이 MCP 서버를 사용하려면:

1. 서버를 시작합니다(위와 같이)

2. Cursor에서 MCP 서버 경로를 main.py 를 가리키도록 구성합니다.

3. Cursor 내에서 Jira 도구를 직접 사용하세요

사용 가능한 도구

JQL 검색

JQL(Jira Query Language)을 사용하여 Jira 문제를 검색합니다.

예:

문제 받기

ID 또는 키를 이용해 특정 Jira 이슈에 대한 세부 정보를 검색합니다.

예:

개발

프로젝트 구조

• main.py : MCP 서버의 진입점

• src/server.py : 주요 MCP 서버 구현

• src/tools/jira_tools.py : Jira API 도구 구현

• src/tool_schemas.py : 도구 스키마 정의

새로운 도구 추가

새로운 Jira 관련 도구를 추가하려면:

1. src/tools/jira_tools.py 에 도구 기능을 구현합니다.

2. src/tool_schemas.py 에 도구 스키마를 추가합니다.

3. src/server.py 에 도구를 등록합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• 모델 컨텍스트 프로토콜

• 파이썬 MCP SDK

• Atlassian Jira API