Jira MCP Server

Integrations

  • Connects to Atlassian's Jira platforms (Cloud, Server, or Data Center) using various authentication methods including Basic Auth, API tokens, and Personal Access Tokens.

  • Provides tools for interacting with Jira's REST API, enabling project browsing, issue management (viewing, creating, searching), commenting on issues, and transitioning issues through workflows.

Jira MCP サーバー

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

特徴

  • アクセス可能なすべての Jira プロジェクトを取得する
  • 特定の Jira の問題の詳細を取得する
  • JQL (Jira クエリ言語) を使用して問題を検索する
  • 新しい Jira 課題を作成する
  • 問題にコメントを追加する
  • 問題に利用可能な遷移を取得する
  • 新しいステータスへの移行の問題

インストール

前提条件

  • 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 の問題を新しいステータスに移行する

ライセンス

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

-
security - not tested
A
license - permissive license
-
quality - not tested

自然言語コマンドを使用して Jira の REST API との対話を可能にするモデル コンテキスト プロトコル サーバー。これにより、ユーザーは Claude Desktop やその他の MCP クライアントを通じて Jira プロジェクト、問題、コメント、ワークフローを管理できます。

  1. Features
    1. Installation
      1. Prerequisites
      2. Activate a virtual environment (recommended)
      3. Using uv (recommended)
      4. Using pip
    2. Configuration
      1. Environment Variables
      2. Environment File (Local Development)
    3. Usage
      1. Command Line
      2. Docker
    4. Claude Desktop Integration
      1. Authentication
        1. Basic Authentication
        2. API Token (Jira Cloud)
        3. Personal Access Token (Jira Server/Data Center)
      2. Available Tools
        1. License
          ID: 0thkelrd3n