remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables retrieving and searching JIRA issues using JQL (JIRA Query Language), with support for configurable field selection, pagination, and logging work on issues.

JIRA MCP 서버

JIRA와 Cursor IDE를 통합하기 위한 간단한 모델 컨텍스트 프로토콜(MCP) "바이브 코딩" 서버입니다. MCP는 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 지원하는 개방형 프로토콜입니다.

이 구현은 Cursor에서 초기화하지 못한 다른 JIRA MCP 서버를 삭제하는 것으로 시작되었습니다.

주의하세요! 이 문서조차 거의 전부 AI 코딩 도우미가 작성했습니다.

특징

키별로 JIRA 이슈 가져오기
JQL(JIRA 쿼리 언어)을 사용하여 문제 검색
이슈 생성 및 업데이트(참고: 사용자 정의가 많은 JIRA 프로젝트의 경우 제한이 있을 수 있음)
이슈에 댓글 추가
복제 문제(필수 사용자 정의 필드를 해결하는 데 유용하지만 복잡한 프로젝트 구성에는 제한이 있을 수 있음)
구성 가능한 필드 선택
페이지 매김 지원
자세한 오류 처리 및 로깅
로그 작업

사용자 워크플로

검색 및 필터 흐름

지엑스피1

문제 복제 흐름

문제 수명 주기 및 인증 흐름을 포함한 자세한 기술 아키텍처 및 시스템 워크플로는 ARCHITECTURE.md를 참조하세요.

MCP 소개

이 서버는 모델 컨텍스트 프로토콜(Model Context Protocol) 사양을 구현하여 Cursor IDE가 AI 기능을 통해 JIRA 데이터와 원활하게 상호 작용할 수 있도록 합니다. 이 프로토콜은 LLM 애플리케이션이 외부 데이터 소스 및 도구와 통신하는 방식을 표준화합니다.

설정

가상 환경 만들기:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

종속성 설치:

pip install -r requirements.txt

환경 변수 구성: 다음을 사용하여 .env 파일을 만듭니다.

JIRA_URL=your_jira_url
JIRA_USERNAME=your_username
JIRA_API_TOKEN=your_api_token

용법

서버를 실행합니다:

./run-jira-mcp.sh

개발

이 프로젝트는 모듈식 구조를 따릅니다.

src/
├── core/           # Core JIRA client implementation
│   ├── __init__.py
│   ├── client.py   # JiraClient class
│   └── config.py   # Configuration management
├── models/         # Pydantic models for validation
│   ├── __init__.py
│   ├── comment.py  # Comment-related models
│   ├── issue.py    # Issue-related models
│   └── worklog.py  # Worklog-related models
└── operations/     # MCP operation implementations
    ├── __init__.py
    ├── comments.py # Comment operations
    ├── issues.py   # Issue operations
    ├── projects.py # Project operations
    └── worklog.py  # Worklog operations

주요 구성 요소

모델 ( src/models/ )
- IssueType , IssueArgs - 이슈 생성/업데이트 모델
- IssueTransitionArgs - 문제 상태 전환 모델
- CloneIssueArgs - 이슈 복제 모델
- CommentArgs , GetCommentsArgs - 댓글 모델
- LogWorkArgs - 작업 로깅 모델
코어 ( src/core/ )
- JiraClient - 메인 JIRA API 클라이언트
- JiraConfig - 구성 관리
- 오류 처리 및 로깅
작업 ( src/operations/ )
- 이슈 관리(가져오기, 검색, 생성, 업데이트, 복제)
- 주석 처리(add, get)
- 작업 로깅
- 프로젝트 목록

이 프로젝트는 IMPLEMENTATION_PLAN.md 에 설명된 구현 계획을 따릅니다.

현재 버전: v0.4

✅ 기본 JIRA 통합
✅ JQL 지원을 통한 검색 기능
✅ 고도로 맞춤화된 프로젝트에 대한 제한 사항이 있는 이슈 관리(생성, 업데이트, 복제)
✅ 댓글 기능
✅ 작업 로깅

특허

MIT

보안 고려 사항

이 도구는 주로 개인 워크플로 자동화 및 개별 개발자용으로 설계되었습니다. 다음 보안 고려 사항을 숙지하시기 바랍니다.

⚠️ 사용 권장 사항

개인/개발용 : JIRA 워크플로를 관리하는 개별 개발자에게 이상적입니다.
소규모 팀 사용 : 적절한 보안 조치를 갖춘 신뢰할 수 있는 팀 환경에 적합
권장하지 않는 대상 :
- 현재 형태의 생산 배포
- 멀티 테넌트 환경
- 대중을 대상으로 하는 서비스
- 민감/규제 데이터 처리

🔒 보안 요구 사항

이 도구를 사용하려면 다음 사항을 확인하세요.

귀하의 JIRA 인스턴스는 HTTPS를 사용합니다.
인증에 API 토큰(비밀번호 아님)을 사용하고 있습니다.
.env 파일은 적절하게 보호되었으며 버전 제어에 커밋되지 않았습니다.
JIRA 액세스를 사용하여 타사 도구를 실행하는 데 따르는 위험을 이해합니다.

🛡️ 모범 사례

API 토큰을 정기적으로 회전하세요
예상치 못한 활동을 확인하기 위해 JIRA 감사 로그를 모니터링하세요.
도구의 최신 버전을 사용하세요
환경에서 사용하기 전에 코드를 검토하세요

📝 기업 사용에 대한 참고 사항

이 도구는 현재 기업 보안 요구 사항에 맞춰 강화되지 않았습니다. 기업 배포를 위한 솔루션이 필요한 경우 다음을 고려하세요.

추가 보안 제어 구현
보안 검토 수행
프로젝트에 보안 개선 사항 기여
공식 엔터프라이즈급 대안 사용

보안 관련 우려 사항이 있거나 취약점을 보고하려면 문제를 제기하거나 유지 관리자에게 직접 문의하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Cursor IDE와 JIRA 간의 원활한 통합을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, 사용자가 문제를 검색하고, JQL 검색을 실행하고, 자연어 상호 작용을 통해 작업을 기록할 수 있도록 합니다.

JIRA MCP Server