Jira MCP Server 9ga

🚀 Jira MCP サーバー

jira-python ライブラリを使用して Jira REST API と相互作用する Model Context Protocol (MCP) サーバーです。このサーバーは、Claude Desktop やその他の MCP クライアントと統合でき、自然言語コマンドを通じて Jira と対話できます。

✨ 主な機能

• アクセス可能なすべての Jira プロジェクトを取得する
• 特定の Jira 問題の詳細情報を取得する
• JQL（Jira クエリ言語）を使用して問題を検索する
• 新しい Jira 問題を作成する
• 問題にコメントを追加する
• 問題の利用可能な遷移状態を取得する
• 問題を新しい状態に遷移させる

📦 インストール

前提条件

• Python 3.9 以上
• Jira インスタンス（クラウド、サーバー、またはデータセンター）
• uv（依存関係管理に推奨ですが、オプション）

仮想環境のアクティブ化（推奨）

# mcp サーバーディレクトリに仮想環境をインストールする
python -m venv .
# 仮想環境をアクティブ化する
source bin/activate

uv を使用する（推奨）

# uv がインストールされていない場合は、まずインストールする
pip install uv

# Jira MCP サーバーをインストールする
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

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

Claude Desktop との統合

このサーバーを Claude Desktop と統合するには、以下の手順を実行します。

1. 上記の方法のいずれかを使用してサーバーをインストールする。
2. Claude Desktop で：
   • 設定 -> 開発者に移動する。
   • 編集設定をクリックする。
   • 選択したエディターで JSON 構成ファイルを開く。
   • 以下の JSON を追加する（注意：使用する環境変数はトークン認証に適用され、他の認証方法とは互換性がありません）。

{
  "mcpServers": {
    "jira": {
      "command": "<UV インストールパス> 例: /Users/<ユーザー名>/.local/bin/uv",
      "args": [
          "--directory",
          "<JIRA MCP パス>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<あなたの Jira ユーザー名>",
          "JIRA_TOKEN": "<あなたのアクセストークン>"
        }
    }
  }
}

📄 ライセンス

MIT