Skip to main content
Glama
deenesjakoruzh
TastyHeadphones

jira-context-mcp

by TastyHeadphones
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

jira-context-mcp

jira-context-mcp는 Jira URL에서 구조화된 Jira 이슈 컨텍스트를 가져오는 프로덕션 중심의 MCP 서버입니다. Codex 및 Claude Code와 같은 코딩 에이전트가 이슈의 의도와 구현 컨텍스트를 빠르게 이해할 수 있도록 설계되었습니다.

이 서버의 기능

  • 하나의 MCP 도구 제공: get_jira_issue_from_url

  • 입력된 URL이 JIRA_BASE_URL에 속하는지 검증

  • 다양한 Jira URL 형태에서 Jira 이슈 키 추출

  • Jira Cloud REST API 호출:

    • GET /rest/api/3/issue/{issueIdOrKey}?expand=names,renderedFields

  • Jira 서식 있는 텍스트(Atlassian Document Format)를 일반 텍스트로 변환

  • 에이전트가 읽기 쉬운 간결하고 구조화된 이슈 컨텍스트 반환

Related MCP server: JIRA MCP Server

지원되는 Jira 이슈 유형

이 서버는 이슈 유형에 구애받지 않습니다. 다음을 포함한 모든 Jira 이슈 유형에서 작동합니다:

  • 버그(Bug)

  • 기능 요청(Feature request)

  • 작업(Task)

  • 스토리(Story)

  • 에픽(Epic)

  • 요구사항(Requirement)

  • 개선사항(Improvement)

  • 지원 티켓(Support ticket)

  • 사용자 지정 이슈 유형

필수 환경 변수

  • JIRA_EMAIL: Jira 계정 이메일

  • JIRA_API_TOKEN: Jira API 토큰

  • JIRA_BASE_URL: Jira Cloud 테넌트 URL (예: https://your-domain.atlassian.net)

빠른 설정 명령어

Codex (전역 설치 없음)

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Claude Code (전역 설치 없음)

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

선택 사항: 먼저 전역으로 설치

npm install -g github:TastyHeadphones/jira-context-mcp

그런 다음 로컬 바이너리로 추가:

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp
claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

도구

get_jira_issue_from_url

입력:

{
  "url": "string"
}

지원되는 URL 예시:

  • ${JIRA_BASE_URL}/browse/ABC-123

  • ${JIRA_BASE_URL}/jira/software/projects/ABC/boards/1/backlog?selectedIssue=ABC-123

  • ABC-123과 같은 이슈 키를 포함하는 JIRA_BASE_URL 하위의 모든 Jira URL

반환되는 구조화된 데이터에는 다음이 포함됩니다:

  • issueKey, issueUrl, summary

  • description (가능한 경우 일반 텍스트)

  • issueType, status, statusCategory, priority

  • assignee, reporter

  • labels, components

  • fixVersions, affectedVersions

  • created, updated, dueDate

  • parent, epic

  • subtasks, linkedIssues

  • attachments (메타데이터만)

  • comments (최근 10개)

  • acceptanceCriteria (설명/사용자 지정 필드에서 최선의 노력으로 추출)

  • customFields (비어 있지 않고 정규화된, 사람이 읽을 수 있는 형식)

Jira API 토큰 생성

  1. Atlassian API 토큰 설정을 엽니다.

  2. Create API token을 클릭합니다.

  3. 토큰 이름을 지정하고 복사합니다.

  4. 해당 값을 JIRA_API_TOKEN으로 사용합니다.

로컬 실행

  1. 종속성 설치:

npm install

  1. 환경 변수 설정 (쉘/세션의 .env 등을 통해).

  2. 빌드:

npm run build

  1. 시작:

npm start

개발 모드:

npm run dev

MCP 구성 예시

MCP 클라이언트 구성에서 이 서버 항목을 사용하세요:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-context-mcp/dist/index.js"],
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-token",
        "JIRA_BASE_URL": "https://your-domain.atlassian.net"
      }
    }
  }
}

Claude Code MCP 구성 예시

Claude Code MCP 서버 구성 파일에서 위의 동일한 JSON 블록을 사용하세요.

Codex MCP 구성 예시

Codex MCP 서버 구성 파일에서 위의 동일한 JSON 블록을 사용하세요.

도구 호출 예시

{
  "name": "get_jira_issue_from_url",
  "arguments": {
    "url": "https://your-domain.atlassian.net/browse/ABC-123"
  }
}

출력 예시

{
  "issueKey": "ABC-123",
  "issueUrl": "https://your-domain.atlassian.net/browse/ABC-123",
  "summary": "Prevent duplicate webhook retries",
  "description": "As a platform engineer, I need retry deduplication ...",
  "acceptanceCriteria": "- Duplicate deliveries are ignored\n- Metrics include dropped duplicates",
  "issueType": "Story",
  "status": "In Progress",
  "statusCategory": "In Progress",
  "priority": "High",
  "assignee": {
    "accountId": "5b10ac8d82e05b22cc7d4ef5",
    "displayName": "Alex Example",
    "emailAddress": null,
    "active": true
  },
  "labels": ["webhook", "idempotency"],
  "components": ["API"],
  "fixVersions": ["2026.05"],
  "affectedVersions": ["2026.04"],
  "subtasks": [],
  "linkedIssues": [],
  "attachments": [],
  "comments": [],
  "customFields": []
}

보안 참고 사항

  • JIRA_API_TOKEN을 비밀로 유지하세요. 소스 제어에 절대 커밋하지 마세요.

  • 토큰과 연결된 계정에 최소 권한의 Jira 액세스 권한을 사용하세요.

  • 이 서버는 이슈 데이터와 첨부 파일 메타데이터만 가져오며, 첨부 파일 자체는 다운로드하지 않습니다.

  • URL 검증은 구성된 JIRA_BASE_URL 외부의 URL을 거부합니다.

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Server for JIRA

    kuvanov-2
    F
    license
    Not graded
    quality
    F
    maintenance
    A Model Context Protocol server that enables ChatGPT and other AI assistants to directly interact with JIRA issues, currently offering the ability to retrieve issue details.
    -

  • Jira MCP Server

    imrnbeg
    A
    license
    B
    quality
    D
    maintenance
    Enables fetching and viewing Jira issue details directly through Claude Desktop using secure API token authentication. Provides comprehensive issue information including status, assignee, priority, and descriptions in both human-readable and structured formats.
    10
    424 npm
    1
    MIT