🔗 커서용 JIRA MCP 서버

✨ 특징

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

Related MCP server: MCP Server for Cursor

🚀 빠른 시작

설치

지엑스피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 서버를 직접 테스트해 보세요.

서버를 빌드하고 실행하세요.
npm run build # You must build the project before running it node dist/index.js
Claude Desktop 구성:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
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" } } } }
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_task`	JIRA 이슈에서 로컬 작업을 생성합니다.	`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 publish`	npm 레지스트리에 패키지 빌드 및 게시
`npm run inspect`	디버깅을 위해 MCP 검사기로 실행
`npm run cleanup-ports`	검사자가 사용하는 릴리스 포트
`npm test`	테스트 실행