파이썬 지라 MCP 서버

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

개요

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

특징

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
종속성을 설치합니다.
pip install -r requirements.txt
Jira 자격 증명을 설정하세요.
cp .env.example .env # Edit .env with your Jira credentials

용법

서버 실행

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

python main.py

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

./main.py

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

커서와 통합

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

서버를 시작합니다(위와 같이)
Cursor에서 MCP 서버 경로를 main.py 를 가리키도록 구성합니다.
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 관련 도구를 추가하려면:

src/tools/jira_tools.py 에 도구 기능을 구현합니다.
src/tool_schemas.py 에 도구 스키마를 추가합니다.
src/server.py 에 도구를 등록합니다.

특허

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

감사의 말

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI 모델이 모델 컨텍스트 프로토콜을 통해 Jira와 상호 작용할 수 있도록 하는 서버 구현으로, JQL 검색 및 문제 세부 정보 검색과 같은 작업이 가능합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Jira MCP Server
uddeshya-23
-
security
F
license
-
quality
Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
Last updated -
2
TypeScript
HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
Jira MCP Server
samuelrizzo
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
Last updated -
15
1
TypeScript
MIT License
MCP Server for JIRA
kuvanov-2
A
security
F
license
A
quality
A Model Context Protocol server that enables ChatGPT and other AI assistants to directly interact with JIRA issues, currently offering the ability to retrieve issue details.
Last updated -
TypeScript

View all related MCP servers

Python Jira MCP Server