Python Jira MCP サーバー

Jira APIと統合されたPythonによるモデルコンテキストプロトコル（MCP）サーバー実装。これにより、AIモデルは標準化されたプロトコルを介してJiraと連携できるようになります。

概要

このMCPサーバーは、Jira API操作を、モデルコンテキストプロトコルをサポートするAIモデルで使用できるツールとして公開します。このサーバーは、Cursorなどのクライアントと通信するためのstdioトランスポートメカニズムを実装しています。

特徴

• JQL 検索ツール: JQL クエリを使用して Jira の問題を検索します

• 問題取得ツール: 特定の Jira 問題に関する詳細情報を取得します

• MCP SDK統合:公式MCP Python SDKと互換性があります

• フォールバックモード: SDKが利用できない場合の最小限の実装

• 環境設定: 環境変数から Jira の資格情報を読み込む

要件

• Python 3.8以上

• Jira API アクセス (API トークン、メール、ドメイン)

• 必要な Python パッケージ:

  • mcp (モデルコンテキストプロトコル Python SDK)

  • aiohttp (HTTP リクエスト用)

  • pydantic （検証用）

  • python-dotenv （環境変数用）

インストール

1. このリポジトリをクローンします:

   git clone https://github.com/yourusername/python-jira-mcp.git cd python-jira-mcp

2. 依存関係をインストールします。

   pip install -r requirements.txt

3. Jira の資格情報を設定します。

   cp .env.example .env # Edit .env with your Jira credentials

使用法

サーバーの実行

MCP サーバーを起動するには、次のコマンドを実行します。

または、実行可能ファイルを直接使用します。

サーバーが起動し、標準入力 (stdin) で MCP メッセージをリッスンし、標準出力 (stdout) で応答します。

カーソルとの統合

この MCP サーバーを Cursor で使用するには:

1. サーバーを起動します（上記の通り）

2. カーソルで、MCPサーバのパスをmain.pyを指すように設定します。

3. カーソル内で直接 Jira ツールを使用する

利用可能なツール

JQL検索

JQL (Jira クエリ言語) を使用して Jira の問題を検索します。

例：

問題を取得

特定の Jira 問題の詳細を ID またはキーで取得します。

例：

発達

プロジェクト構造

• main.py : MCPサーバーのエントリポイント

• src/server.py : メインMCPサーバーの実装

• src/tools/jira_tools.py : Jira API ツールの実装

• src/tool_schemas.py : ツールスキーマの定義

新しいツールの追加

新しい Jira 関連ツールを追加するには:

1. src/tools/jira_tools.pyにツール関数を実装します。

2. src/tool_schemas.pyにツールスキーマを追加します。

3. src/server.pyにツールを登録する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• モデルコンテキストプロトコル

• Python MCP SDK

• アトラシアン Jira API