MCP Jira 통합

Jira를 사용하는 팀을 위해 LLM이 프로젝트 관리자 및 개인 비서 역할을 할 수 있도록 지원하는 간단한 MCP(Model Context Protocol) 서버입니다. Jira REST API v3를 기반으로 구축되었습니다.

주요 기능

핵심 MCP 도구

• create_issue - 적절한 형식과 ADF 설명을 사용하여 새로운 Jira 이슈 생성

• search_issues - 스마트 형식 지정 및 페이지 매김을 사용하여 JQL로 이슈 검색

• get_sprint_status - 지표가 포함된 포괄적인 스프린트 진행 상황 보고서 가져오기

• get_team_workload - 팀원 업무량 및 역량 분석

• generate_standup_report - 일일 스탠드업 보고서 자동 생성

프로젝트 관리 기능

• 다중 프로젝트 지원: 프로젝트 키를 동적으로 지정하여 여러 프로젝트 작업 가능

• 시각적 지표를 통한 스프린트 진행 상황 추적

• 팀 업무량 분석 및 역량 계획

• 자동화된 일일 스탠드업 보고서 생성

• 적절한 우선순위 지정과 함께 이슈 생성

• 스마트 이슈 검색 및 필터링

신뢰성

• 속도 제한(429) 및 일시적 오류(503) 발생 시 지수 백오프를 통한 자동 재시도

• 대규모 결과 집합에 대한 페이지 매김

• 시간대 인식 날짜 처리

• 사용자 지정 Jira 상태 및 이슈 유형에 대한 유연한 처리

Related MCP server: JIRA MCP Server

요구 사항

• Python 3.8 이상

• API 토큰이 있는 Jira Cloud 계정

• MCP 호환 클라이언트 (예: Claude Desktop)

빠른 설정

1. 복제 및 설치:

git clone https://github.com/your-org/mcp-jira.git
cd mcp-jira
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Jira 자격 증명 구성:

cp .env.example .env
# Edit .env with your values

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token
PROJECT_KEY=PROJ
DEFAULT_BOARD_ID=123

3. 서버 테스트:

.venv/bin/python -m mcp_jira

출력에 Initializing MCP Jira server...가 표시되어야 합니다. 중지하려면 Ctrl+C를 누르세요.

사용 예시

이슈 생성

"로그인 시스템이 제대로 작동하지 않는 문제에 대해 높은 우선순위의 버그를 생성해 줘"

• 적절한 이슈 유형, 우선순위 및 형식을 자동으로 할당

스프린트 관리

"현재 스프린트 상태는 어때?"

• 지표와 시각적 지표가 포함된 포괄적인 진행 상황 보고서를 가져옴

팀 관리

"john.doe, jane.smith, mike.wilson의 팀 업무량을 보여줘"

• 역량을 분석하고 업무량 분포를 제공