Python Jira MCP

🚀 Python Jira MCP サーバー

Pythonで実装されたModel Context Protocol (MCP) サーバーで、Jira APIと統合されています。このサーバーにより、AIモデルは標準化されたプロトコルを通じてJiraとやり取りすることができます。

🚀 クイックスタート

このMCPサーバーは、Jira API操作をツールとして公開し、Model Context Protocolに対応したAIモデルが使用できます。また、stdio伝送メカニズムを実装しており、Cursorなどのクライアントと通信できます。

✨ 主な機能

• JQL検索ツール：JQLクエリを使用してJiraの問題を検索します。
• 問題取得ツール：特定のJira問題の詳細情報を取得します。
• MCP SDK統合：公式のMCP Python SDKと互換性があります。
• 降格モード：SDKがない場合でも最小限の実装を提供します。
• 環境設定：環境変数からJiraの認証情報を読み込みます。

📦 インストール

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
# .envファイルでJiraの認証情報を編集します

💻 使用例

基本的な使用法

サーバーの起動

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

python main.py

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

./main.py

サーバーは標準入力（stdin）でMCPメッセージを待ち受け、標準出力（stdout）で応答します。

Cursorとの統合

このMCPサーバーをCursorと組み合わせて使用するには：

1. サーバーを起動します（上記の手順を参照）。
2. CursorでMCPサーバーのパスをmain.pyに設定します。
3. Cursor内で直接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"]
  }
}

問題取得

IDまたはキーを使用して特定のJira問題の詳細情報を取得します。

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

📚 ドキュメント

プロジェクト構造

• main.py：サーバーのメインプログラムです。
• tools/：Jiraツールを含むディレクトリです。
• requirements.txt：依存関係のリストです。
• .env.example：環境変数のサンプルファイルです。

貢献ガイド

1. リポジトリをクローンします：

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

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

pip install -r requirements.txt

3. サーバーを起動してテストします：

python main.py

4. 開発を開始し、変更をコミットします。

📄 ライセンス

このプロジェクトは LICENSE の下で公開されています。

🔗 連絡先

質問や提案がある場合は、your.email@example.com までご連絡ください。