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>"
      }
    }
  }
}

3. 次のような質問を 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 の問題を新しいステータスに移行する

ライセンス

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