파이썬 지라 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 서버를 시작하려면 다음을 실행하세요.

python main.py

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

./main.py

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

커서와 통합

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

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

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

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

사용 가능한 도구

JQL 검색

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

예:

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

문제 받기

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

예:

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

개발

프로젝트 구조

• 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