jira-mcp-server

jira-mcp-server

LLM が一連の API ツールを通じて Jira とやり取りできる MCP サーバーです。このサーバーは言語モデルと Jira の機能をつなぎ、課題の管理と追跡を自動化できるようにします。

機能

• JQL を使用した Jira 課題の検索
• 新しい課題の作成
• 課題の詳細の取得
• 既存の課題の更新
• 課題の削除

Cursor でのセットアップ

mcp.json ファイルに新しいエントリを追加します：

"jira": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "JIRA_BASE_URL",
        "-e",
        "JIRA_EMAIL",
        "-e",
        "JIRA_TOKEN",
        "chasepd/jira-mcp-server:latest"
      ]
      "env":{
        "JIRA_BASE_URL": "[THE BASE URL OF YOUR JIRA INSTANCE]",
        "JIRA_EMAIL": "[EMAIL OF YOUR JIRA ACCOUNT]",
        "JIRA_TOKEN": "[YOUR JIRA API TOKEN]"
      }
    }

前提条件

• Python 3.x
• API アクセス権のある Jira アカウント
• Jira 認証用の環境変数：
  • JIRA_BASE_URL
  • JIRA_EMAIL
  • JIRA_TOKEN

開発環境のセットアップ

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

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

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

pip install -r requirements.txt

3. 環境変数を設定します：

export JIRA_BASE_URL="your-jira-instance-url"
export JIRA_EMAIL="[email protected]"
export JIRA_TOKEN="your-api-token"

サーバーの実行

ローカル開発

python src/mcp-server.py

Docker を使用する

サーバーは Docker イメージ chasepd/jira-mcp-server として利用できます。

最新バージョンをプルして実行します：

docker pull chasepd/jira-mcp-server:latest
docker run -e JIRA_BASE_URL="your-jira-instance-url" \
           -e JIRA_EMAIL="[email protected]" \
           -e JIRA_TOKEN="your-api-token" \
           -p 8000:8000 \
           chasepd/jira-mcp-server:latest

利用可能なツール

サーバーは、Jira とやり取りするための以下のツールを提供します：

• jira_search_issues(jql: str): JQL を使用して課題を検索します
• jira_create_issue(project_key: str, summary: str, description: str, issuetype: str): 新しい課題を作成します
• jira_get_issue(issue_key: str): 特定の課題の詳細を取得します
• jira_update_issue(issue_key: str, fields: dict): 既存の課題を更新します
• jira_delete_issue(issue_key: str): 課題を削除します

コントリビュート

コントリビュートを歓迎します！追加してほしい機能があれば、お気軽にプルリクエストを送信してください。