커서용 Jira MCP 서버

Jira와 통합된 TypeScript 기반 MCP 서버로, Cursor가 Jira 티켓과 상호 작용할 수 있습니다.

특징

• Jira 티켓 목록

• 티켓 세부 정보 받기

• 티켓에 대한 코멘트를 받으세요

• 새로운 티켓 만들기

• 티켓에 댓글 추가

• 티켓 상태 업데이트

• 커서 통합을 위한 전체 MCP 프로토콜 지원

Related MCP server: Jira MCP Server

설정

1. 종속성 설치:

지엑스피1

2. .env.example 기반으로 .env 파일을 만들고 Jira 자격 증명을 입력합니다.

Jira API 토큰을 받으려면:

1. https://id.atlassian.com/manage/api-tokens 에 로그인하세요

2. "API 토큰 만들기"를 클릭하세요

3. 토큰을 복사하여 .env 파일에 붙여넣으세요.

개발

개발 서버를 실행합니다.

빌드하고 실행

프로젝트를 빌드하세요:

서버를 시작합니다:

커서 통합

이 MCP 서버를 Cursor와 함께 사용하려면 두 가지 옵션이 있습니다.

옵션 1: 명령 기반 통합(권장)

1. 프로젝트를 빌드하세요:

2. 커서 설정 열기:

   • 커서 메뉴를 클릭하세요

   • "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)

   • "확장" 또는 "통합" 섹션으로 이동합니다.

3. MCP 구성을 추가합니다.

/path/to/jira-mcp-cursor 프로젝트의 절대 경로로 바꾸세요.

옵션 2: HTTP 기반 통합(대안)

1. MCP 서버를 시작합니다(아직 실행 중이 아니면):

2. 커서 설정 열기:

   • 커서 메뉴를 클릭하세요

   • "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)

   • "확장" 또는 "통합" 섹션으로 이동합니다.

3. MCP 구성을 추가합니다.

커서에서 Jira 사용

MCP 서버를 구성한 후에는 Cursor에서 Jira 명령을 직접 사용할 수 있습니다.

• /jira list - 티켓을 나열합니다

• /jira view TICKET-123 - 티켓 세부 정보 보기

• /jira comments TICKET-123 - 티켓 댓글 받기

• /jira create - 새 티켓을 만듭니다.

• /jira comment TICKET-123 - 댓글 추가

• /jira status TICKET-123 - 티켓 상태 업데이트

MCP 프로토콜 지원

서버는 Cursor에 필요한 MCP(Model-Client-Protocol)를 구현합니다.

• 명령 기반 통합을 위한 Stdio 통신

• Jira 작업을 위한 도구 등록

API 엔드포인트

티켓 목록

JQL 쿼리로 필터링하여 선택적으로 Jira 티켓 목록을 검색합니다.

엔드포인트: GET /api/tickets

쿼리 매개변수:

요청 예시:

응답 예시:

티켓 받기

특정 티켓에 대한 자세한 정보를 검색합니다.

엔드포인트: GET /api/tickets/:id

경로 매개변수:

요청 예시:

응답 예시:

티켓 코멘트 받기

특정 티켓에 대한 모든 댓글을 검색합니다.

엔드포인트: GET /api/tickets/:id/comments

경로 매개변수:

요청 예시:

응답 예시:

티켓 생성

새로운 Jira 티켓을 만듭니다.

엔드포인트: POST /api/tickets

요청 본문:

요청 예시:

응답 예시:

댓글 추가

기존 티켓에 새로운 댓글을 추가합니다.

엔드포인트: POST /api/tickets/:id/comments

경로 매개변수:

요청 본문:

요청 예시:

응답 예시:

업데이트 상태

기존 티켓의 상태를 업데이트합니다.

엔드포인트: POST /api/tickets/:id/status

경로 매개변수:

요청 본문:

요청 예시:

응답 예시:

티켓 검색

텍스트 검색을 사용하여 지정된 프로젝트 전반의 티켓을 검색합니다.

엔드포인트: GET /api/tickets/search

쿼리 매개변수:

요청 예시:

응답 예시: