MCP Jira Python

🚀 MCP JIRA Python

MCP JIRA Pythonは、JIRAとの統合を行うMCPサーバーのPython実装です。MCPは通信プロトコルで、あなたのAIにツールを提供し、データの安全性を保護します（必要に応じてローカル化も可能）。このサーバーは、あなたのAIアプリケーションと同じコンピューター上で動作し、Claude Desktopは最初にMCPサーバーを実行するアプリケーション（クライアントでもあります）です。簡単なPython MCPクライアントについては、examplesフォルダを参照してください。

🚀 クイックスタート

MCP JIRA Pythonを使うことで、JIRAとの統合を簡単に行うことができます。以下の手順を参照して、サーバーをセットアップし、Claude Desktopを構成しましょう。

📦 インストール

# サーバーをローカルにインストールする
git clone https://github.com/kallows/mcp-jira-python.git 

✨ 主な機能

このMCPサーバーは、以下のJIRA統合ツールを提供します。

• delete_issue：問題キーを使用して、Jiraの問題またはサブタスクを削除します。
• create_jira_issue：新しいJiraの問題を作成し、タイトル、説明、タイプ、優先度、担当者などのカスタムフィールドをサポートします。
• get_issue：指定された問題キーの完全な問題詳細を取得し、コメントや添付ファイルも含みます。
• create_issue_link：問題間の関係（例：「ブロックする」、「ブロックされる」など）を作成します。
• update_issue：既存の問題を更新し、タイトル、説明、状態、優先度、担当者などの新しいフィールド値を設定します。
• get_user：メールアドレスを使用して、ユーザーのアカウントIDを検索します。
• list_fields：JIRAのすべての利用可能なフィールドとその属性のリストを取得します。
• list_issue_types：あなたのJIRAインスタンス内のすべての利用可能な問題タイプを取得します。
• list_link_types：問題リンクのすべての可能な関係タイプを取得します。
• search_issues：JQL（JIRAクエリ言語）を使用して、特定のプロジェクト内で問題を検索します。
• add_comment：既存の問題にテキストコメントを追加します。
• add_comment_with_attachment：添付ファイル付きで問題にコメントを追加します。

📚 ドキュメント

Claude Desktopの設定

これには、claude_desktop_config.jsonを更新する必要があります。ファイルの場所は、Apple、Windows、Linuxによって異なります。

Windows

注意：Windowsでは、claude_desktop_config.jsonのパスは次のとおりです。

%AppData%\\Claude\\claude_desktop_config.json

これは通常、C:\Users\YOURUSERNAME\AppData\Roaming\Claudeに解決されます。

以下は、claude_desktop_config.jsonに追加する必要がある設定ブロックです。 Windowsでは、常に完全パスを使用します。あなたは"command"を更新し、ディレクトリパスを設定し、JIRA環境設定を追加します。

    "jira-api": {
      "command": "C:\\\\Users\\\\YOURUSERNAME\\\\.local\\\\bin\\\\uv.exe",
      "args": [
        "--directory",
        "D:\\\\mcp\\\\mcp-jira-python",
        "run",
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

☠️注意 - クローズドデスクトップを閉じ、すべてのClaudeプロセスを終了してから、更新されたclaude_desktop_config.jsonを有効にする必要があります！

Mac/Linux

以下の内容をclaude_desktop_config.jsonに追加します。

    "jira-api": {
      "command": "python3",
      "args": [
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

同様に、ターミナルで次のコマンドを実行する必要があります。

python3 -m mcp_jira_python.server

プロジェクト構造

MCP-JIRA-Python/
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py