Python Jira MCP サーバー

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

概要

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

Related MCP server: Jira MCP Server

特徴

• 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 サーバーを起動するには、次のコマンドを実行します。

python main.py

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

./main.py

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

カーソルとの統合

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

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

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

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

利用可能なツール

JQL検索

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

例：

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

問題を取得

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

例：

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

発達

プロジェクト構造

• 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