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のようなコーディングエージェントが、課題の意図や実装の背景を迅速に理解できるように設計されています。

このサーバーの機能

  • 1つの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課題タイプで動作します:

  • バグ

  • 機能リクエスト

  • タスク

  • ストーリー

  • エピック

  • 要件

  • 改善

  • サポートチケット

  • カスタム課題タイプ

必要な環境変数

  • 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

  • JIRA_BASE_URL 配下にある ABC-123 のような課題キーを含むすべての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. APIトークンを作成 をクリックします。

  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