Jira MCP Server

Jira MCP サーバー

このプロジェクトは、Jira と MCP（Model Context Protocol）をつなぐブリッジとして動作するサーバーです。MCP インターフェースを通じて、Jira データの同期や操作を行えます。

使用技術

• Kotlin：主なプログラミング言語
• Ktor：REST API を作成するための Web フレームワーク
• Gradle：ビルドシステム
• Docker：アプリケーションのコンテナ化
• MCP（Model Context Protocol）：相互運用に使用する通信プロトコル

Docker パッケージ

このプロジェクトでは、GitHub Container Registry にビルドしてプッシュする 2 つの Docker イメージを提供します。

• jira-mcp-stdio：stdio モードの通信向けに設定されたイメージです。
• jira-mcp-sse：SSE（Server-Sent Events）モードの通信向けに設定されたイメージです。

注：これらのイメージは、メインブランチが更新されると自動的にビルドされ、プッシュされます。

以下のコマンドを使用して、GitHub Container Registry からこれらのイメージをプルできます。

docker pull ghcr.io/noxfr/jira-mcp-stdio:latest
docker pull ghcr.io/noxfr/jira-mcp-sse:latest

開発の前提条件

• Java 21 以降
• Docker と Docker Compose
• 適切な権限を持つ Jira アカウント

設定

このプロジェクトでは、以下の環境変数が必要です。

• JIRA_URL：Jira インスタンスの URL
• JIRA_EMAIL：Jira アカウントに関連付けられたメールアドレス
• JIRA_API_TOKEN：Jira API トークン

MCP モードは 2 種類あります：SSE または stdio

Docker Compose でローカル実行する

docker-compose.yml の設定例は以下のとおりです。

services:
  jira-mcp-server:
    image: ghcr.io/noxfr/jira-mcp-sse:latest
    ports:
      - "3001:3001"
    environment:
      - JIRA_URL=https://your-instance.atlassian.net
      - [email protected]
      - JIRA_PAT=your_jira_api_token

ビルドと実行

ビルド済みの Docker イメージをプルして実行するには、以下のコマンドを使用します。

# Pull the Docker image
docker pull ghcr.io/noxfr/jira-mcp-sse:latest

# Run the service with Docker Compose
docker-compose up

または、イメージをローカルでビルドする場合は、以下のコマンドを使用します。

# Build the Docker image
docker-compose build

# Start the service
docker-compose up

サーバーにはポート 3001 でアクセスできます。

MCP の追加

IDE 内での設定

HTTP（jira-mcp-sse イメージを使用）

{
  "mcpServers": {
    "mcp-kotlin-jira-server": {
      "url": "http://127.0.0.1:3001/sse"
    }
  }
}

Stdio（jira-mcp-stdio イメージを使用）

{
  "mcpServers": {
    "mcp-kotlin-jira-stdio": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_EMAIL",
        "-e",
        "JIRA_PAT",
        "ghcr.io/noxfr/jira-mcp-stdio:latest"
      ],
      "env": {
        "JIRA_URL": "TBD",
        "JIRA_EMAIL": "TBD",
        "JIRA_PAT": "TBD"
      }
    }
  }
}

AI アシスタントでの使用例

AI アシスタント（Claude Desktop や Cursor など）を通じて MCP を操作する例を紹介します。

• プロジェクト XXX のラベルエラーに関するチケットをすべて修正し、レビューに設定する
• チケット XXX の実装案を提案する など

利用可能なツール

このサーバーは、MCP を通じて以下のツールを公開します。

• search_issues：JQL を使用して JIRA の課題を検索します。
• get_issue：コメントを含む、特定の JIRA 課題の詳細情報を取得します。
• update_issue：既存の JIRA 課題を更新します。
• get_transitions：JIRA 課題で利用可能なステータス遷移を取得します。
• transition_issue：遷移を実行して、JIRA 課題のステータスを変更します。
• get_users：JIRA ユーザーを検索します。
• assign_issue：JIRA 課題をユーザーに割り当てます。