JIRA MCP Server for Cursor

Integrations

  • Provides system time integration with customizable date and time formatting and locale support.

  • Allows access to Jira issues directly from the IDE, including viewing assigned issues, getting detailed information on specific issues, and converting Jira issues into local tasks.

🔗 커서용 JIRA MCP 서버


✨ 특징

  • 📋 커서에서 직접 JIRA에 액세스
    • IDE를 벗어나지 않고도 할당된 문제를 확인하세요
    • 하나의 명령으로 특정 문제에 대한 자세한 정보를 얻으세요
    • JIRA 이슈를 원활하게 로컬 작업으로 변환
  • 시스템 시간 통합
    • 사용자 정의 가능한 날짜 및 시간 형식
    • date-fns를 통한 로케일 지원

🚀 빠른 시작

설치

지엑스피1

구성

다음 변수를 사용하여 .env 파일을 만듭니다.

JIRA_HOST=https://your-instance.atlassian.net JIRA_USERNAME=your-email@example.com JIRA_API_TOKEN=your-jira-api-token-here

🔑 JIRA API 토큰에 대한 중요 참고 사항

  • 토큰에는 = 기호를 포함한 특수 문자가 포함될 수 있습니다.
  • .env 파일에 토큰을 한 줄로 넣으세요.
  • 토큰 값 주위에 따옴표를 추가하지 마십시오.
  • Atlassian에서 제공한 대로 토큰을 정확하게 붙여넣으세요.

🛠️ 개발 도구

MCP 검사관

MCP Inspector는 MCP 서버를 테스트하고 디버깅하는 강력한 도구입니다.

# Run the inspector (no separate build step needed) npm run inspect

검사관은 자동으로 다음을 수행합니다.

  • .env 에서 환경 변수를 로드합니다.
  • 점유된 포트(5175, 3002)를 정리합니다.
  • 필요할 때 프로젝트를 빌드합니다
  • 구성에 따라 MCP 서버를 시작합니다.
  • 검사기 UI를 시작합니다

http://localhost:5175?proxyPort=3002 에서 검사기를 방문하세요.

포트 충돌이 발생하는 경우:

npm run cleanup-ports

Inspector를 사용한 디버깅

검사기 UI를 사용하면 다음을 수행할 수 있습니다.

  • 사용 가능한 모든 MCP 기능 보기
  • 도구 실행 및 응답 검토
  • JSON 통신 분석
  • 다양한 매개변수로 테스트

자세한 내용은 MCP Inspector GitHub 저장소를 참조하세요.

Claude Desktop과 통합

Claude를 통해 MCP 서버를 직접 테스트해 보세요.

  1. 서버를 빌드하고 실행하세요.
    npm run build # You must build the project before running it node dist/index.js
  2. Claude Desktop 구성:
    nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. MCP 구성을 추가합니다.
    { "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }
  4. Claude Desktop을 다시 시작하고 다음을 사용하여 테스트하세요.
    What time is it right now?
    또는
    Show me my assigned JIRA issues.

🔌 커서 IDE와의 통합

⚠️ 중요: Cursor IDE 또는 Claude Desktop과 통합하기 전에 npm run build 로 프로젝트를 빌드해야 합니다.

Cursor IDE의 MCP 구성에 이 MCP 서버를 추가하세요.

{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }

🧰 사용 가능한 도구

JIRA 도구

도구설명매개변수보고
jira_get_assigned_issues귀하에게 할당된 모든 문제를 검색합니다.없음마크다운 형식의 문제 목록
jira_get_issue특정 문제에 대한 자세한 정보를 얻습니다.issueKey : 발급키(예: PD-312)마크다운 형식의 이슈 세부 정보
jira_create_taskJIRA 이슈에서 로컬 작업을 생성합니다.issueKey : 발급키(예: PD-312)마크다운 형식의 작업

시스템 시간 도구

도구설명매개변수보고
get_system_time현재 시스템 시간을 가져옵니다format : (선택 사항) date-fns 형식 문자열형식화된 날짜/시간 문자열

📁 프로젝트 구조

src/ ├── features/ # MCP features (JIRA, system time) ├── server/ # MCP server implementation ├── shared/ # Shared utilities └── index.ts # Main entry point

NPM 스크립트

명령설명
npm run build프로젝트를 빌드하세요
npm run publishnpm 레지스트리에 패키지 빌드 및 게시
npm run inspect디버깅을 위해 MCP 검사기로 실행
npm run cleanup-ports검사자가 사용하는 릴리스 포트
npm test테스트 실행

📘 리소스

📄 라이센스

MIT © 스타니슬라프 스테파넨코


-
security - not tested
F
license - not found
-
quality - not tested

JIRA를 Cursor IDE에 직접 통합하는 모델 컨텍스트 프로토콜 서버로, 사용자는 편집기에서 나가지 않고도 할당된 이슈를 보고, 특정 티켓에 대한 자세한 정보를 얻고, JIRA 이슈를 로컬 작업으로 변환할 수 있습니다.

  1. ✨ Features
    1. 🚀 Quick Start
      1. Installation
      2. Configuration
    2. 🛠️ Development Tools
      1. MCP Inspector
      2. Integration with Claude Desktop
    3. 🔌 Integration with Cursor IDE
      1. 🧰 Available Tools
        1. JIRA Tools
        2. System Time Tools
      2. 📁 Project Structure
        1. NPM Scripts
      3. 📘 Resources
        1. 📄 License
          ID: yw8bnyz919