Jira MCP 서버

Jira용 모델 컨텍스트 프로토콜 서버.

MCP를 통해 Jira와 통합을 제공하여 LLM이 Jira와 상호 작용할 수 있도록 합니다.

Jira REST API 문서

설치

수동 설치

참고: Node 버전이 22.12.0 이상이어야 합니다.

1. Jira 개인 액세스 토큰 생성 또는 받기: 가이드
2. Claude Desktop에 서버 구성 추가:
   • MacOS: ~/라이브러리/애플리케이션 지원/클로드/claude_desktop_config.json
   • Windows: 이 가이드를 확인하세요

지엑스피1

Windows의 경우:

구성 요소

도구

1. list_projects : Jira의 프로젝트를 나열합니다.
   • 필수 입력 사항:
     • query (선택적 문자열): 반환된 프로젝트를 필터링하는 데 사용되는 쿼리 문자열입니다.
     • maxResults (선택적 숫자, 최대: 100): 반환할 결과의 최대 개수입니다.
     • expand (선택적 문자열): 응답의 추가 정보를 확장합니다. ( description , lead , issueTypes , url , projectKeys , permissions 및 insight 쉼표로 구분).
2. list_boards : 프로젝트의 보드를 나열합니다.
   • 필수 입력 사항:
     • projectKeyOrId (문자열): 프로젝트의 키 또는 ID입니다.
     • name (선택적 문자열): 프로젝트 이름입니다.
     • maxResults (선택적 숫자, 최대: 100): 반환할 결과의 최대 개수입니다.
     • startAt (선택적 숫자): 반환된 보드의 시작 인덱스입니다.
     • type (선택적 문자열): 보드의 유형입니다.( scrum 또는 kanban 중 하나일 수 있음).
3. list_sprints_from_board : 보드에서 스프린트를 나열합니다.
   • 필수 입력 사항:
     • boardId (문자열): 보드의 ID입니다.
     • maxResults (선택적 숫자, 최대: 100): 반환할 결과의 최대 개수입니다.
     • startAt (선택적 숫자): 반환된 보드의 시작 인덱스입니다.
4. list_issues_from_sprint : 스프린트의 이슈를 나열합니다.
   • 필수 입력 사항:
     • boardId (문자열): 보드의 ID입니다.
     • sprintId (문자열): 스프린트의 ID입니다.
     • maxResults (선택적 숫자, 최대: 100): 반환할 결과의 최대 개수입니다.
     • startAt (선택적 숫자): 반환된 보드의 시작 인덱스입니다.
     • expand (선택적 문자열): 응답의 추가 정보를 확장합니다. ( schema 와 names 쉼표로 구분).
5. create_issue : Jira에서 이슈를 생성합니다(작업 이슈 유형만 지원).
   • 필수 입력 사항:
     • projectKeyOrId (문자열): 프로젝트의 키 또는 ID입니다.
     • summary (문자열): 이슈의 요약/제목.
     • description (문자열): 문제에 대한 설명입니다.

사용 예

Jira와 상호 작용하는 데 사용할 수 있는 몇 가지 프롬프트 예는 다음과 같습니다.

1. "모든 Jira 프로젝트 보기" → list_projects 도구를 실행하여 사용 가능한 모든 프로젝트를 확인합니다.
2. "DEV 프로젝트에는 어떤 칸반 보드가 있나요?" → DEV 프로젝트 키와 유형 매개변수를 "kanban"으로 설정하여 list_boards 도구를 실행합니다.
3. "보드 ID 123에 대한 모든 스프린트를 보여주세요" → list_sprints_from_board 도구를 실행하여 보드 123과 관련된 모든 스프린트를 확인하세요.
4. "123번 보드의 스프린트 456에는 어떤 이슈가 있나요?" → list_issues_from_sprint 도구를 실행하여 123번 보드의 스프린트 456에 있는 모든 이슈를 확인하세요.
5. "마케팅 보드에서 현재 스프린트의 처음 50개 이슈를 보여주세요" → 먼저 list_boards를 실행하여 마케팅 보드 ID를 찾은 다음, list_sprints_from_board를 실행하여 현재 스프린트를 찾은 다음, maxResults=50으로 list_issues_from_sprint를 실행합니다.

개발

1. 종속성 설치:

2. .env 에서 Github 액세스 토큰을 구성합니다.

3. 시계를 사용하여 로컬로 실행:

4. 서버를 빌드하세요:

5. 검사기를 사용한 로컬 디버깅:

토도스

• [x] 프로젝트 목록
• [x] 리스트_보드
• [x] 보드에서 스프린트 목록
• [x] 스프린트에서_발생_문제_목록
• [ ] ID 또는 키로 발급 받기
• [x] create_issue (작업 문제 유형만 해당)
• [ ] create_issue(스토리, 에픽, 하위 작업 이슈 유형)
• [ ] 업데이트_문제
• [ ] 문제_삭제
• [ ] 이슈 보관
• [ ] 이슈에 대한 댓글 목록
• [ ] 이슈에서 댓글을 가져오려면 ID를 사용하세요
• [ ] 이슈에_댓글_생성
• [ ] 이슈_주석_업데이트
• [ ] 이슈_댓글_삭제
• [ ] 이슈의 하위 작업 목록
• [ ] 사용자 이름 또는 키로 사용자를 가져옵니다