remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Supports loading Jira credentials from environment variables using python-dotenv for secure configuration.
Integrates with Atlassian's Jira API, enabling AI models to perform Jira operations like searching for issues and retrieving issue details.
Provides tools for searching Jira issues with JQL queries and retrieving detailed information about specific Jira issues, including fields like summary, description, status, and assignee.

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 （環境変数用）

インストール

このリポジトリをクローンします:
git clone https://github.com/yourusername/python-jira-mcp.git cd python-jira-mcp
依存関係をインストールします。
pip install -r requirements.txt
Jira の資格情報を設定します。
cp .env.example .env # Edit .env with your Jira credentials

使用法

サーバーの実行

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

python main.py

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

./main.py

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

カーソルとの統合

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

サーバーを起動します（上記の通り）
カーソルで、MCPサーバのパスをmain.pyを指すように設定します。
カーソル内で直接 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 関連ツールを追加するには:

src/tools/jira_tools.pyにツール関数を実装します。
src/tool_schemas.pyにツールスキーマを追加します。
src/server.pyにツールを登録する

ライセンス

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

謝辞

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

AI モデルがモデルコンテキストプロトコルを介して Jira と対話し、JQL 検索や問題の詳細の取得などのタスクを実行できるようにするサーバー実装。

Related Resources

Reddit Discussion about this server

Python Jira MCP Server