Jira MCP Server

Jira MCP Server

2026年9月29日をもって廃止されました。 このプロジェクトでは、機能追加、バグ修正、依存関係およびセキュリティのメンテナンスは行われません。既存のコードはMITライセンスの下で引き続き利用できます。新しい Jira Cloud 連携には、公式のAtlassian Rovo MCP Serverをご利用ください。

このローカルの Model Context Protocol（MCP）サーバーは、stdio を介して Jira の操作を MCP クライアントに公開します。実装では、jira-python と Jira Cloud REST API v3 への直接リクエストを組み合わせています。

このプロジェクトが当初対処していた API トークン認証の不足は、現在では Rovo によって解消されています。切り替え前に必要な認証要件、クライアントのセットアップ、ワークフローの確認については、移行ガイドを参照してください。

互換性

• Python 3.10 以降。
• basic_auth を使用する、Atlassian アカウントのメールアドレスと API トークンを備えた Jira Cloud。
• ローカルの stdio サーバーを起動できる MCP クライアント。

直接 API クライアントは /rest/api/3 を使用します。PAT のみの認証を含む Jira Server および Data Center との互換性は検証されておらず、この廃止リリースではサポートされていません。これらの構成がサポートされているとする以前のドキュメントの記述は誤りでした。残されているレガシー認証の分岐は、エンドツーエンドの互換性を保証するものではありません。

利用可能なツール

ツール	目的
get_jira_projects	アクセス可能な Jira プロジェクトを一覧表示します。
get_jira_issue	キーを指定して課題を取得します。
search_jira_issues	JQL を使用して課題を検索します。
create_jira_issue	課題を1件作成します。
create_jira_issues	Jira の一括 API を使用して複数の課題を作成します。
add_jira_comment	課題にコメントを追加します。
get_jira_transitions	利用可能なワークフローのトランジションを一覧表示します。
transition_jira_issue	課題を別のステータスに遷移させます。
create_jira_project	Jira の権限に応じてプロジェクトを作成します。
get_jira_project_issue_types	プロジェクトで利用可能な課題タイプを一覧表示します。

レガシーインストール

最終版のコードとドキュメントを入手するには、このリポジトリをチェックアウトしてください。以前公開されたパッケージには、廃止に伴う修正が含まれていない場合があります。

uv を使用してソースからインストール

uvをインストールしてから、次を実行します。

git clone https://github.com/InfinitIQ-Tech/mcp-jira.git
cd mcp-jira
uv sync

pip を使用してソースからインストール

python -m venv .venv
source .venv/bin/activate
python -m pip install .

過去のパッケージインストールコマンドは uv pip install mcp-server-jira と python -m pip install mcp-server-jira です。

レガシー構成

Jira Cloud 用に、次の環境変数を設定します。

export JIRA_SERVER_URL="https://your-domain.atlassian.net"
export JIRA_AUTH_METHOD="basic_auth"
export JIRA_USERNAME="[email protected]"
export JIRA_TOKEN="your_api_token"

JIRA_USERNAME は Atlassian アカウントのメールアドレスです。JIRA_TOKEN は、そのアカウントの Jira Cloud API トークンです。JIRA_PASSWORD と token_auth はレガシーコードに残っていますが、Jira Cloud で推奨される構成ではありません。認証情報はバージョン管理に含めないでください。

リポジトリには .env.example が含まれています。uv で .env ファイルを使用するには、明示的に渡します。

cp .env.example .env
# Edit .env with your Jira Cloud credentials.
uv run --env-file .env mcp-server-jira

環境変数がすでに設定されている場合は、次のいずれかを実行します。

uv run mcp-server-jira

または、pip でインストールした後に次を実行します。

python -m mcp_server_jira

Docker

このサーバーは HTTP リスナーではなく stdio を使用します。MCP クライアント経由で起動するときは、stdin を開いたままにしてください。

docker build -t mcp-jira .
docker run --rm -i --env-file .env mcp-jira

ローカル MCP クライアント構成の例

Claude Desktop など、mcpServers コマンド構成に対応しているクライアントでは、uv とリポジトリのチェックアウトへの絶対パスを使用します。

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-jira",
        "run",
        "mcp-server-jira"
      ],
      "env": {
        "JIRA_SERVER_URL": "https://your-domain.atlassian.net",
        "JIRA_AUTH_METHOD": "basic_auth",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_TOKEN": "your_api_token"
      }
    }
  }
}

クライアントの構成場所や対応トランスポートは異なります。この例はレガシーのローカルサーバーについて説明するものであり、Rovo の構成や、すべてのクライアントでテスト済みであることを示すものではありません。

移行とメンテナンス

ローカルコネクターを削除する前に、Atlassian Rovo MCP への移行に従ってください。Rovo は Atlassian がホストするサービスであり、認証方式、ツール名、レスポンススキーマが異なります。構成を自動的に移行することはできません。

このコードを引き続き使用するユーザー、またはフォークするユーザーは、Jira および MCP クライアントとの将来的なメンテナンスと互換性に責任を負います。

ライセンス

MIT