MCP JIRA 파이썬 🚀

JIRA 통합을 위한 MCP 서버의 Python 구현입니다. MCP는 AI에 도구를 제공하고 데이터를 안전하게(원하는 경우 로컬로) 보호하도록 설계된 통신 프로토콜입니다. 이 서버는 AI 애플리케이션과 동일한 컴퓨터에서 실행되며, Claude Desktop은 MCP 서버를 실행하는 첫 번째 애플리케이션입니다(클라이언트로 간주됩니다. 간단한 Python MCP 클라이언트는 예제 폴더를 참조하세요).

설치

지엑스피1

Related MCP server: Jira MCP Server

사용 가능한 도구

이 MCP 서버는 다음과 같은 JIRA 통합 도구를 제공합니다.

• delete_issue : 이슈 키를 사용하여 Jira 이슈 또는 하위 작업을 삭제합니다.

• create_jira_issue : 요약, 설명, 유형, 우선순위, 담당자 등 사용자 정의 가능한 필드로 새 Jira 이슈를 생성합니다.

• get_issue : 주어진 이슈 키에 대한 코멘트와 첨부 파일을 포함한 전체 이슈 세부 정보를 검색합니다.

• create_issue_link : 이슈 간의 관계를 생성합니다(예: "차단", "차단됨" 등).

• update_issue : 요약, 설명, 상태, 우선순위 또는 담당자와 같은 필드에 대한 새 값으로 기존 문제를 업데이트합니다.

• get_user : 이메일 주소를 사용하여 사용자 계정 ID를 조회합니다.

• list_fields : 사용 가능한 모든 JIRA 필드와 해당 속성 목록을 가져옵니다.

• list_issue_types : JIRA 인스턴스에서 사용 가능한 모든 이슈 유형을 검색합니다.

• list_link_types : 문제 연결에 대한 모든 가능한 관계 유형을 가져옵니다.

• search_issues : 특정 프로젝트 내에서 JQL(JIRA Query Language)을 사용하여 이슈를 검색합니다.

• add_comment : 기존 이슈에 텍스트 코멘트를 추가합니다.

• add_comment_with_attachment : 첨부 파일로 문제에 대한 의견을 추가합니다.

클로드 데스크톱 구성

이렇게 하려면 claude_desktop_config.json 파일을 업데이트해야 합니다. 파일 위치는 Apple, Windows 또는 Linux에 따라 다릅니다.

윈도우

참고: Windows에서 claude_desktop_config.json의 위치는 다음과 같습니다.

%AppData%\\Claude\\claude_desktop_config.json

이는 (일반적으로) C:\Users\YOURUSERNAME\AppData\Roaming\Claude로 확인됩니다.

아래는 claude_desktop_config.json에 추가할 구성 블록입니다. Windows에서는 항상 전체 경로를 사용합니다. "command"를 업데이트하고, 디렉터리 경로를 설정하고, JIRA 환경 설정을 추가하세요.

☠️경고 - 업데이트된 claude_desktop_config.json을 활성화하려면 반드시 Claude Desktop을 닫고 모든 Claude 프로세스를 종료해야 합니다!😬

맥과 리눅스

파일 경로를 mcp-jira-python으로 업데이트하고 JIRA 환경 값을 입력합니다.

메모:

claude_desktop_config.json에 변경 사항을 저장한 후 Claude Desktop을 다시 시작해야 합니다.

MCP JIRA Python 도구 실행

이러한 MCP 도구는 jira-api 서버 아래에 나열되어 있습니다. Claude Desktop 텍스트 입력란 오른쪽 하단에 있는 작은 망치 아이콘을 클릭하면 목록을 볼 수 있습니다. jira-api 도구가 목록에 있는지 확인하세요. 도구를 '실행'하려면 Claude에게 Jira 작업을 구체적으로 요청하기만 하면 됩니다. Claude는 처음에는 도구를 보지 못하고 넛지해야 할 수도 있습니다. 경우에 따라 도구 사용을 거부할 수도 있습니다. 시스템 프롬프트를 업데이트하는 것이 좋습니다.

테스트 실행

TODO - 테스트 실행에 대한 설명 추가(단위 테스트) TODO - 통합 및 시스템 테스트에 다음 환경 변수가 필요하므로 테스트에서 환경 변수를 더 쉽게 가져올 수 있도록 코드를 추가합니다.

export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="your-email@example.com"
export JIRA_API_TOKEN="your-api-token"

TODO - 테스트 커버리지 보고서 생성:

프로젝트 구조

mcp-jira-python/
├── README.md
├── pyproject.toml
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py