local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to JIRA data including searching issues, retrieving epic children, getting detailed issue information, creating and updating issues, extracting issue mentions, tracking issue relationships, handling file attachments, and transforming JIRA content for AI context windows

JIRA MCP 서버

관계 추적, 최적화된 데이터 페이로드, AI 컨텍스트 창에 대한 데이터 정리를 통해 JIRA 데이터에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버 구현입니다.

ℹ️ Confluence에는 별도의 MCP 서버가 있습니다.

특징

JQL을 사용하여 JIRA 문제 검색(요청당 최대 50개 결과)
댓글 기록 및 최적화된 페이로드를 사용하여 Epic Children을 검색합니다(요청당 최대 100개 이슈)
의견 및 관련 문제를 포함한 자세한 문제 정보를 얻으세요
JIRA 이슈 생성, 업데이트 및 관리
이슈에 댓글 추가
Atlassian 문서 형식에서 문제 언급 추출
문제 관계 추적(언급, 링크, 부모/자식, 에픽)
AI 컨텍스트 효율성을 위해 풍부한 JIRA 콘텐츠를 정리하고 변환합니다.
보안된 다중 파트 업로드 처리를 통한 파일 첨부 지원

필수 조건

Bun (v1.0.0 이상)
API 액세스가 가능한 JIRA 계정

환경 변수

지엑스피1

설치 및 설정

1. 저장소를 복제합니다.

git clone [repository-url]
cd jira-mcp

2. 종속성을 설치하고 빌드합니다.

bun install
bun run build

3. MCP 서버를 구성합니다.

적절한 구성 파일을 편집합니다.

맥OS:

클라인: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Claude 데스크톱: ~/Library/Application Support/Claude/claude_desktop_config.json

윈도우:

클라인: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
클로드 데스크톱: %APPDATA%\Claude Desktop\claude_desktop_config.json

리눅스:

클라인: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Claude Desktop: 안타깝게도 아직 존재하지 않습니다.

mcpServers 개체 아래에 다음 구성을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_BASE_URL": "your_jira_instance_url",
        "JIRA_USER_EMAIL": "your_email"
      }
    }
  }
}

4. MCP 서버를 다시 시작합니다.

Cline의 MCP 설정에서 MCP 서버를 다시 시작하세요. Claude Desktop을 다시 시작하여 새 MCP 서버를 로드하세요.

개발

테스트 실행:

bun test

개발을 위한 시청 모드:

bun run dev

변경 후 다시 빌드하려면:

bun run build

사용 가능한 MCP 도구

검색_문제

JQL을 사용하여 JIRA 이슈를 검색하세요. 요청당 최대 50개의 결과를 반환합니다.

입력 스키마:

{
  searchString: string; // JQL search string
}

get_epic_children

댓글과 관계 데이터를 포함하여 서사시의 모든 아동 관련 이슈를 받아보세요. 요청당 100개 이슈로 제한됩니다.

입력 스키마:

{
  epicKey: string; // The key of the epic issue
}

get_issue

댓글과 모든 관계를 포함하여 특정 JIRA 이슈에 대한 자세한 정보를 얻으세요.

입력 스키마:

{
  issueId: string; // The ID or key of the JIRA issue
}

이슈 생성

지정된 필드로 새로운 JIRA 이슈를 생성합니다.

입력 스키마:

{
  projectKey: string, // The project key where the issue will be created
  issueType: string, // The type of issue (e.g., "Bug", "Story", "Task")
  summary: string, // The issue summary/title
  description?: string, // Optional issue description
  fields?: { // Optional additional fields
    [key: string]: any
  }
}

업데이트_문제

기존 JIRA 문제의 필드를 업데이트합니다.

입력 스키마:

{
  issueKey: string, // The key of the issue to update
  fields: { // Fields to update
    [key: string]: any
  }
}

첨부파일 추가

JIRA 이슈에 파일을 첨부합니다.

입력 스키마:

{
  issueKey: string, // The key of the issue
  fileContent: string, // Base64 encoded file content
  filename: string // Name of the file to be attached
}

댓글 추가

JIRA 이슈에 댓글을 추가합니다. 일반 텍스트를 입력받아 내부적으로 필요한 Atlassian 문서 형식으로 변환합니다.

입력 스키마:

{
  issueIdOrKey: string, // The ID or key of the issue to add the comment to
  body: string // The content of the comment (plain text)
}

데이터 정리 기능

Atlassian 문서 형식에서 텍스트를 추출합니다.
설명 및 댓글에서 트랙 문제 언급
관계 유형과 공식적인 문제 링크를 유지합니다.
부모와 자식의 관계를 유지합니다
서사시적 연관성을 추적합니다
작성자 정보가 포함된 댓글 기록이 포함되어 있습니다.
응답에서 불필요한 메타데이터를 제거합니다.
언급된 내용에 대한 콘텐츠 노드를 재귀적으로 처리합니다.
중복 제거 문제 언급

기술적 세부 사항

Strict 모드에서 TypeScript로 빌드됨
향상된 성능을 위해 Bun 런타임을 사용합니다.
최적화된 빌드를 위한 Vite
JIRA REST API v3를 사용합니다
API 토큰을 사용한 기본 인증
관련 데이터에 대한 일괄 API 요청
AI 컨텍스트 창에 대한 최적화된 응답 페이로드
복잡한 Atlassian 구조의 효율적인 변환
강력한 오류 처리
속도 제한 고려 사항
최대 한도:
- 검색 결과: 요청당 50개 이슈
- Epic Children: 요청당 100개 호
보안 파일 첨부를 위한 다중 파트 양식 데이터 지원
자동 콘텐츠 유형 감지 및 검증

오류 처리

서버는 포괄적인 오류 처리 전략을 구현합니다.

네트워크 오류 감지 및 적절한 메시징
HTTP 상태 코드 처리(특히 문제의 경우 404)
상태 코드가 포함된 자세한 오류 메시지
콘솔에 오류 세부 정보 로깅
모든 매개변수에 대한 입력 검증
MCP 프로토콜을 통한 안전한 오류 전파
일반적인 JIRA API 오류에 대한 특수 처리
첨부 파일에 대한 Base64 검증
다중 파트 요청 실패 처리
속도 제한 감지
첨부 매개변수 검증

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENCE 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

모델 컨텍스트 프로토콜을 통해 JIRA 데이터에 액세스하고 관리할 수 있는 인터페이스를 제공하며, AI 애플리케이션을 위한 관계 추적, 데이터 정리, 상황적 통찰력과 같은 기능을 제공합니다.

Related Resources

Reddit Discussion about this server

JIRA MCP Server

Integrations

JIRA MCP 서버

특징

필수 조건

환경 변수

설치 및 설정

1. 저장소를 복제합니다.

2. 종속성을 설치하고 빌드합니다.

3. MCP 서버를 구성합니다.

4. MCP 서버를 다시 시작합니다.

개발

사용 가능한 MCP 도구

검색_문제

get_epic_children

get_issue

이슈 생성

업데이트_문제

첨부파일 추가

댓글 추가

데이터 정리 기능

기술적 세부 사항

오류 처리

특허

Related Resources

Appeared in Searches