커서용 Jira MCP 서버

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

특징

Jira 티켓 목록
티켓 세부 정보 받기
티켓에 대한 코멘트를 받으세요
새로운 티켓 만들기
티켓에 댓글 추가
티켓 상태 업데이트
커서 통합을 위한 전체 MCP 프로토콜 지원

설정

종속성 설치:

지엑스피1

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

JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000

Jira API 토큰을 받으려면:

https://id.atlassian.com/manage/api-tokens 에 로그인하세요
"API 토큰 만들기"를 클릭하세요
토큰을 복사하여 .env 파일에 붙여넣으세요.

개발

개발 서버를 실행합니다.

npm run dev

빌드하고 실행

프로젝트를 빌드하세요:

npm run build

서버를 시작합니다:

npm start

커서 통합

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

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

프로젝트를 빌드하세요:

npm run build

커서 설정 열기:
- 커서 메뉴를 클릭하세요
- "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)
- "확장" 또는 "통합" 섹션으로 이동합니다.
MCP 구성을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-cursor/dist/server.js"]
    }
  }
}

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

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

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

npm start

커서 설정 열기:
- 커서 메뉴를 클릭하세요
- "설정"을 선택하세요(또는 키보드 단축키를 사용하세요)
- "확장" 또는 "통합" 섹션으로 이동합니다.
MCP 구성을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000",
      "capabilities": [
        "list_tickets",
        "get_ticket",
        "get_comments",
        "create_ticket",
        "update_status",
        "add_comment"
      ]
    }
  }
}

커서에서 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

쿼리 매개변수:

매개변수	유형	필수의	설명
제이큐엘	끈	아니요	티켓을 필터링하기 위한 Jira 쿼리 언어(JQL) 문자열

요청 예시:

GET /api/tickets?jql=project=TEST+AND+status=Open

응답 예시:

TEST-123: Example ticket (Open)
TEST-124: Another ticket (In Progress)

티켓 받기

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

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

경로 매개변수:

매개변수	유형	필수의	설명
ID	끈	예	Jira 티켓 ID(예: TEST-123)

요청 예시:

GET /api/tickets/TEST-123

응답 예시:

Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket description

티켓 코멘트 받기

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

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

경로 매개변수:

매개변수	유형	필수의	설명
ID	끈	예	Jira 티켓 ID(예: TEST-123)

요청 예시:

GET /api/tickets/TEST-123/comments

응답 예시:

[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---

[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---

티켓 생성

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

엔드포인트: POST /api/tickets

요청 본문:

매개변수	유형	필수의	설명
요약	끈	예	티켓 요약
설명	끈	예	티켓 설명
프로젝트 키	끈	예	프로젝트 키(예: TEST)
이슈 유형	끈	예	문제 유형(예: 작업, 버그)

요청 예시:

POST /api/tickets
Content-Type: application/json

{
  "summary": "New feature request",
  "description": "Implement new functionality",
  "projectKey": "TEST",
  "issueType": "Task"
}

응답 예시:

Created ticket: TEST-124

댓글 추가

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

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

경로 매개변수:

매개변수	유형	필수의	설명
ID	끈	예	Jira 티켓 ID(예: TEST-123)

요청 본문:

매개변수	유형	필수의	설명
몸	끈	예	댓글 텍스트

요청 예시:

POST /api/tickets/TEST-123/comments
Content-Type: application/json

{
  "body": "This is a new comment"
}

응답 예시:

Added comment to TEST-123

업데이트 상태

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

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

경로 매개변수:

매개변수	유형	필수의	설명
ID	끈	예	Jira 티켓 ID(예: TEST-123)

요청 본문:

매개변수	유형	필수의	설명
전환 ID	끈	예	수행할 전환의 ID

요청 예시:

POST /api/tickets/TEST-123/status
Content-Type: application/json

{
  "transitionId": "21"
}

응답 예시:

Updated status of TEST-123

티켓 검색

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

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

쿼리 매개변수:

매개변수	유형	필수의	설명
검색텍스트	끈	예	티켓에서 검색할 텍스트
프로젝트 키	끈	예	검색할 프로젝트 키의 쉼표로 구분된 목록
최대 결과	숫자	아니요	반환할 최대 결과 수(기본값: 50)

요청 예시:

GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10

응답 예시:

Found 2 tickets matching "login bug"

[TEST] TEST-123: Login page bug
Status: Open (Updated: 3/20/2024, 10:00:00 AM)
Description:
Users unable to login using SSO
----------------------------------------

[PROD] PROD-456: Fix login performance
Status: In Progress (Updated: 3/19/2024, 3:30:00 PM)
Description:
Login page taking too long to load
----------------------------------------

Jira MCP Server for Cursor

Integrations

커서용 Jira MCP 서버

특징

설정

개발

빌드하고 실행

커서 통합

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

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

커서에서 Jira 사용

MCP 프로토콜 지원

API 엔드포인트

티켓 목록

티켓 받기

티켓 코멘트 받기

티켓 생성

댓글 추가

업데이트 상태

티켓 검색

Appeared in Searches