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 Query Language）を使用して 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 までご連絡ください。