mcp-jira-server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Allows AI assistants to manage Jira issues programmatically, including creating, listing, updating, getting details, deleting issues, and adding comments.

Jira MCP 서버

Jira의 REST API와 통합을 제공하는 모델 컨텍스트 프로토콜 서버로, AI 어시스턴트가 Jira 이슈를 프로그래밍 방식으로 관리할 수 있도록 해줍니다.

특징

이 서버는 Jira 문제를 관리하기 위한 도구를 제공합니다.

  • 새로운 이슈 생성(작업, 에픽, 하위 작업)
  • 선택적 상태 필터링을 사용하여 문제 나열
  • 기존 문제 업데이트(요약, 설명, 상태)
  • 자세한 문제 정보를 얻으세요
  • 문제 삭제
  • 이슈에 댓글 추가

설정

필수 조건

  1. API 액세스가 가능한 Jira 계정
  2. Jira API 토큰( Atlassian 계정 설정 에서 생성 가능)

설치

  1. 종속성 설치:

지엑스피1

  1. 서버를 빌드하세요:
npm run build

구성

  1. 작업 디렉토리에 .jira-config.json 파일을 만듭니다.
{ "projectKey": "YOUR_PROJECT_KEY" }
  1. Jira 자격 증명을 사용하여 MCP 서버를 구성하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "jira": { "command": "node", "args": ["/path/to/jira-server/build/index.js"], "env": { "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token", "JIRA_DOMAIN": "your-domain" } } } }

사용 가능한 도구

이슈 생성

새로운 Jira 이슈를 생성합니다.

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
    • 요약: 호 제목
    • 설명: 문제 설명
    • 유형: 이슈 유형(작업, 에픽 또는 하위 작업)

목록_문제

프로젝트의 문제를 나열합니다

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
  • 선택 매개변수:
    • 상태: 상태별로 필터링(예: "해야 할 일", "진행 중", "완료")

업데이트_문제

기존 문제를 업데이트합니다

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
    • issue_key: 발급 키(예: PRJ-123)
  • 선택 매개변수:
    • 요약: 새로운 제목
    • 설명: 새로운 설명
    • 상태: 새로운 상태

get_issue

특정 문제에 대한 자세한 정보를 얻습니다.

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
    • issue_key: 발급 키(예: PRJ-123)

삭제_문제

Jira 이슈를 삭제합니다

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
    • issue_key: 발급 키(예: PRJ-123)

댓글 추가

기존 문제에 주석을 추가합니다.

  • 필수 매개변수:
    • working_dir: .jira-config.json이 포함된 디렉토리
    • issue_key: 발급 키(예: PRJ-123)
    • comment: 추가할 댓글 텍스트

개발

자동 재빌드를 사용한 개발의 경우:

npm run watch

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

  • 잘못된 프로젝트 키
  • 구성이 누락되었습니다
  • 잘못된 문제 유형
  • API 인증 오류
  • 잘못된 상태 전환

출력 형식

문제 정보는 다음을 포함하도록 형식화되어 있습니다.

  • 이슈 키 및 요약
  • 문제 유형 및 상태
  • 생성 날짜 및 생성자
  • 설명
  • 작성자 및 타임스탬프가 포함된 댓글(있는 경우)

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Jira의 REST API와 통합을 제공하여 AI 어시스턴트가 Jira 이슈를 프로그래밍 방식으로 관리할 수 있도록 합니다.

  1. Features
    1. Setup
      1. Prerequisites
      2. Installation
      3. Configuration
    2. Available Tools
      1. create_issue
      2. list_issues
      3. update_issue
      4. get_issue
      5. delete_issue
      6. add_comment
    3. Development
      1. Error Handling
      2. Output Formatting
    ID: 2a6ts4367i