Jira-Context-MCP

by rahulthedevil
Verified

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

  • Uses .ENV for configuration management, allowing users to set up Jira connection details including base URL, username, and API token.

  • Enables GitHub integration for code analysis and workflow management as evidenced by the CodeQL badge and GitHub Actions workflow reference.

  • Integrates with Jira's API to fetch issue details, retrieve assigned tickets, filter issues by type, list projects, get issue types, and track recent changes in tickets, enabling AI-powered Jira ticket management directly within Cursor IDE.

Jira 컨텍스트 MCP

Jira에 대한 MCP(모델 컨텍스트 프로토콜) 구현을 통해 다음을 수행할 수 있습니다.

  • Jira 티켓 링크를 입력하여 문제 세부 정보를 가져오고 Cursor에게 수정을 지시합니다.
  • 지정된 Jira 프로젝트 내에서 귀하에게 할당된 모든 티켓을 검색합니다.
  • 특정 문제 유형을 기준으로 Jira 문제를 필터링하고 Cursor가 자동으로 문제를 해결하도록 지시합니다.
  • 자동화 및 효율성을 위해 Jira API와 완벽하게 통합

설정

필수 조건

  • Node.js 20.17.0 이상
  • API 액세스가 가능한 Jira 계정
  • Jira API 토큰( Atlassian API 토큰 에서 생성 가능)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Jira Context MCP를 자동으로 설치하려면:

지엑스피1

수동 설치

  1. 이 저장소를 복제하세요:
    git clone https://github.com/yourusername/Jira-Context-MCP.git cd Jira-Context-MCP
  2. 종속성 설치:
    npm install # or if you use pnpm pnpm install
  3. 다음 예를 기반으로 .env 파일을 만듭니다.
    cp .env.example .env
  4. Jira 세부정보로 .env 파일을 편집합니다.
    JIRA_BASE_URL=https://your-domain.atlassian.net JIRA_USERNAME=your-email@example.com JIRA_API_TOKEN=your-api-token-here HTTP_PORT=3000

짓다

다음을 사용하여 프로젝트를 빌드하세요.

npm run build # or pnpm build

용법

서버 시작

HTTP 서버를 시작합니다.

npm start # or pnpm start

또는 CLI 모드를 사용하세요.

npm run start:cli # or pnpm start:cli

커서로 연결하기

  1. 커서에서 명령 팔레트를 엽니다(Ctrl+Shift+P 또는 Cmd+Shift+P)
  2. "MCP 서버에 연결"을 입력하세요.
  3. "MCP 서버에 연결"을 선택하세요
  4. 서버 URL을 입력하세요(기본값: http://localhost:3000/sse )

사용 가능한 도구

연결되면 Cursor에서 다음 도구를 사용할 수 있습니다.

1. Jira 이슈 세부 정보 가져오기

특정 Jira 문제에 대한 자세한 정보를 가져옵니다.

/get_issue issueKey:PROJECT-123

2. 문제 할당 받기

특정 프로젝트에서 귀하에게 할당된 문제를 검색합니다.

/get_assigned_issues projectKey:PROJECT maxResults:10

3. 유형별 문제 가져오기

유형(버그, 스토리, 에픽 등)별로 문제 필터링:

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. 프로젝트 받기

사용 가능한 모든 프로젝트를 나열하세요.

/get_projects

5. 문제 유형 가져오기

사용 가능한 모든 문제 유형을 나열하세요.

/get_issue_types

6. 최근 티켓 변경 사항 가져오기

프로젝트에서 지정된 기간(예: 지난 7일) 동안 티켓에 적용된 변경 사항을 검색합니다.

/get_recent_changes projectKey:PROJECT maxDays:7

명령 예제

🚀 Jira MCP 서버 + 커서 IDE = AI 기반 Jira 어시스턴트! 개발자의 업무 효율을 높이는 방법:

📂 "내가 접근할 수 있는 모든 Jira 프로젝트 나열"
→ AI가 사용 가능한 모든 프로젝트를 즉시 가져옵니다.
더 이상 수동으로 검색할 필요가 없습니다!

📋 "PROJECT의 모든 이슈를 나열하세요"
→ AI가 모든 미해결 티켓을 검색합니다.
노력 없이도 체계적으로 정리하세요!

🐛 "버그나 변경 요청만 필터링하여 수정하세요"
→ AI가 이를 식별하고 커서를 지시하여 해결합니다.
자동화로 문제를 더 빠르게 해결하세요!

"나에게 할당된 모든 티켓을 찾아 수정하세요"
→ AI가 사용자의 작업을 끌어와 커서가 처리하도록 합니다.
아무런 번거로움 없이 업무를 완벽하게 처리하세요!

🔍 "Jira 이슈 PROJECT-123에 대한 세부 정보 가져오기"
→ AI가 몇 초 만에 전체 문제 정보를 가져옵니다.
더 이상 탭을 전환할 필요가 없습니다!

📊 "지난 7일 동안 PROJECT 티켓에 어떤 변화가 있었나요?"
→ AI가 최근 업데이트를 추적하고 주요 변경 사항을 강조합니다.
더 이상 수동으로 티켓 내역을 확인할 필요가 없습니다!

🔥 요약: 이제 AI가 Jira + 커서를 사용합니다! 프로젝트 가져오기, 이슈 필터링, 변경 사항 추적, 버그 수정 등 모든 작업을 IDE 내에서 처리하세요.
백로그에서 버그 수정까지, MCP Server를 사용하면 Jira를 효과적으로 활용할 수 있습니다!

예제 워크플로

특정 버그 수정

  1. Cursor에서 Jira MCP 서버에 연결합니다.
  2. 문제에 대한 세부 정보를 확인하세요.
    /get_issue issueKey:PROJECT-123
  3. 문제 세부 정보를 검토하고 Cursor에게 해결 방법을 지시하세요.
    Fix the bug described in PROJECT-123

할당된 문제에 대한 작업

  1. Cursor에서 Jira MCP 서버에 연결합니다.
  2. 할당된 문제를 검색하세요:
    /get_assigned_issues projectKey:PROJECT
  3. 다음 문제 중 하나에 대해 Cursor에게 도움을 요청하세요.
    Help me solve the first issue in my assigned list

프로젝트의 모든 버그 수정

  1. Cursor에서 Jira MCP 서버에 연결합니다.
  2. 모든 버그 문제를 검색합니다.
    /get_issues_by_type issueType:Bug projectKey:PROJECT
  3. 커서 지시:
    Help me fix these bugs one by one

최근 변경 사항 검토

  1. Cursor에서 Jira MCP 서버에 연결합니다.
  2. 최근 티켓 업데이트 검색:
    /get_recent_changes projectKey:PROJECT maxDays:7
  3. 변경 사항을 검토하여 수정 사항에 대한 최신 정보를 받으세요.

개발

프로젝트 구조

  • src/ - 소스 코드
    • services/ - Jira API 서비스
    • types/ - TypeScript 유형 정의
    • utils/ - 유틸리티 함수
    • server.ts - MCP 서버 구현
    • index.ts - 애플리케이션 진입점
    • cli.ts - CLI 진입점

새로운 도구 추가

새로운 도구를 추가하려면 src/server.ts 파일을 편집하고 registerTools 메서드에 새로운 도구 정의를 추가합니다.

특허

MIT

작가

라훌 데이 - @rahulthedevil

ID: a8ob8depqc