Skip to main content
Glama
Jira MCP Server

Jira MCP Server

Jira MCP サーバー

jira-pythonライブラリを使用して Jira の REST API とやり取りするためのモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは Claude Desktop やその他の MCP クライアントと統合されており、自然言語コマンドを使用して Jira とやり取りできます。

特徴

  • アクセス可能なすべての Jira プロジェクトを取得する

  • 特定の Jira の問題の詳細を取得する

  • JQL (Jira クエリ言語) を使用して問題を検索する

  • 新しい Jira 課題を作成する

  • 問題にコメントを追加する

  • 問題に利用可能な遷移を取得する

  • 新しいステータスへの移行の問題

Related MCP server: JIRA MCP Tools

インストール

前提条件

  • Python 3.9以上

  • Jira インスタンス (クラウド、サーバー、またはデータセンター)

  • uv (オプションですが依存関係の管理には推奨)

仮想環境をアクティブ化する(推奨)

# Install a Virtual Environment (VENV) in the mcp server directory
python -m venv .
# Activate the virtual environment
source bin/activate

uvの使用(推奨)

# Install uv if you don't have it
pip install uv

# Install the Jira MCP server
uv pip install mcp-server-jira

pipの使用

pip install mcp-server-jira

構成

環境変数

環境変数を使用してサーバーを構成します。

  • JIRA_SERVER_URL : Jira サーバーの URL

  • JIRA_AUTH_METHOD : 認証方法 ('basic_auth' または 'token_auth')

  • JIRA_USERNAME : 基本認証のユーザー名

  • JIRA_PASSWORD : 基本認証のパスワード

  • JIRA_TOKEN : APIトークンまたは個人アクセストークン

環境ファイル(ローカル開発)

ルート ディレクトリに構成を記述した.envファイルを作成することもできます。

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token

使用法

コマンドライン

python -m mcp_server_jira

ドッカー

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

クロードデスクトップ統合

このサーバーをClaude Desktopで使用するには:

  1. 上記のいずれかの方法でサーバーをインストールします

  2. Claude Desktopの場合:

    • 設定 -> 開発者に移動

    • 設定の編集をクリック

    • お好みのエディタでJSON設定を開きます

    • 次の JSON を追加します: ( NOTE : 使用される環境変数はトークン認証用であり、他の認証方法では機能しません)

{
  "mcpServers": {
    "jira": {
      "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
      "args": [
          "--directory",
          "<PATH TO JIRA MCP>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<USERNAME>",
          "JIRA_TOKEN": "<TOKEN>"
      }
    }
  }
}
  1. 次のような質問を Claude にすることで、Jira と対話できるようになりました。

    • 「Jira にあるすべてのプロジェクトを表示」

    • 「問題 PROJECT-123 の詳細を取得する」

    • 「プロジェクトに「ログインの問題を修正」という概要で新しいバグを作成します」

    • 「自分に割り当てられたすべての未解決のバグを見つける」

認証

サーバーは複数の認証方法をサポートしています:

基本認証

ユーザー名とパスワードを使用した Jira Server/Data Center の場合:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"

API トークン (Jira Cloud)

API トークンを使用する Jira Cloud の場合:

JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"

個人アクセストークン (Jira Server/Data Center)

PAT を使用する Jira Server/Data Center (8.14+) の場合:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"

利用可能なツール

  1. get_projects : アクセス可能なすべての Jira プロジェクトを取得する

  2. get_issue : キーで特定の Jira 問題の詳細を取得する

  3. search_issues : JQL を使用して Jira の問題を検索する

  4. create_issue : 新しい Jira の問題を作成する

  5. add_comment : Jira の問題にコメントを追加する

  6. get_transitions : Jira の問題で利用可能なワークフロー遷移を取得する

  7. transition_issue : Jira の問題を新しいステータスに移行する

ライセンス

マサチューセッツ工科大学

Available Tools

10 tools
add_jira_commentC

Add a comment to a Jira issue

Inputs: comment (required), issue_key (required).

create_jira_issueC

Create a new Jira issue. Common issue types include 'Bug', 'Task', 'Story', 'Epic' (capitalization handled automatically)

Inputs: description (required), issue_type (required), project (required), summary (required), +1 more.

create_jira_issuesC

Bulk create new Jira issues. IMPORTANT: For 'issue_type', use the exact case-sensitive types in your Jira instance (common: 'Bug', 'Task', 'Story', 'Epic')

Inputs: field_list (required), prefetch.

create_jira_projectC

Create a new Jira project

Inputs: key (required), assignee, avatarId, categoryId, +8 more.

get_jira_issueC

Get details for a specific Jira issue by key

Inputs: issue_key (required).

get_jira_project_issue_typesB

Get all available issue types for a specific Jira project

Inputs: project_key (required).

get_jira_projectsB

Get all accessible Jira projects

Inputs: no named parameters.

get_jira_transitionsC

Get available workflow transitions for a Jira issue

Inputs: issue_key (required).

search_jira_issuesC

Search for Jira issues using JQL (Jira Query Language)

Inputs: jql (required), max_results.

transition_jira_issueC

Transition a Jira issue to a new status

Inputs: issue_key (required), transition_id (required), comment, fields.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific Jira resources and actions. The tools cover different operations like creation, retrieval, searching, and transitions without overlap, making it easy for an agent to select the right tool for each task.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'jira' as a prefix (e.g., create_jira_issue, get_jira_projects). The naming is uniform across all tools, using snake_case and clear action verbs, which enhances predictability and readability.

    Tool Count5/5

    With 10 tools, this server is well-scoped for Jira operations, covering core functionalities like issue management, project handling, and workflow transitions. Each tool serves a specific purpose without redundancy, making the count appropriate for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for key Jira workflows, including CRUD operations for issues and projects, searching, and transitions. A minor gap is the lack of tools for updating or deleting issues or projects, which agents might need to work around, but core operations are well-covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
      7
      2
      TypeScript
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to interact with Jira Cloud instances, providing capabilities for issue management, project listing, and JQL search.
      1
      2
      MIT