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.

Integrations

Supports loading Jira credentials from environment variables using python-dotenv for secure configuration.
Integrates with Atlassian's Jira API, enabling AI models to perform Jira operations like searching for issues and retrieving issue details.
Provides tools for searching Jira issues with JQL queries and retrieving detailed information about specific Jira issues, including fields like summary, description, status, and assignee.

파이썬 지라 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

F

license - not found

-

quality - not tested

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

Related Resources

Reddit Discussion about this server

Python Jira MCP Server