Script

🚀 Jira MCP（モデル制御プロトコル）

GolangベースのJira MCPコネクタで、ClaudeなどのAIアシスタントがAtlassian Jiraと相互作用できるようにします。このツールは、AIモデルが一般的なJira操作を実行できるシームレスなインターフェースを提供します。

✨ 主な機能

• 詳細な問題情報を取得する
• 問題（サブ問題を含む）を作成、更新、検索する
• すべての利用可能な問題タイプと状態をリストする
• コメントを追加および検索する
• 問題に作業ログを追加する
• Sprintをリストし管理する
• 問題の履歴と関係を検索する
• 問題をリンクし、関連する問題を取得する
• ワークフローを通じて問題を遷移させる

📦 インストール

要件： Golang 1.20+（ソースコードからビルドする場合）

Jira MCPをインストールする方法はいくつかあります。

方法1：GitHubリリースからダウンロード

1. GitHubリリースページにアクセスします。
2. あなたのプラットフォームに適したバイナリファイルをダウンロードします。
   • jira-mcp_linux_amd64 はLinux用
   • jira-mcp_darwin_amd64 はmacOS用
   • jira-mcp_windows_amd64.exe はWindows用
3. Linux/macOSの場合、バイナリファイルを実行可能にします。

   chmod +x jira-mcp_*
   

4. それをPATHディレクトリ（Linux/macOS）に移動します。

   sudo mv jira-mcp_* /usr/local/bin/jira-mcp
   

方法2：Goを使用してインストール

go install github.com/nguyenvanduocit/jira-mcp@latest

方法3：Docker

Dockerを直接使用する

1. GitHubコンテナregistryから事前構築されたイメージを取得します。

   docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest
   

2. または、ローカルでDockerイメージを構築します。

   docker build -t jira-mcp .
   

📚 ドキュメント

環境変数

以下の環境変数は認証に使用され、必須です。

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

設定方法は次のとおりです。

1. Docker実行コマンドで直接設定する（推奨）
2. .env ファイルを使用する（オプション、ローカル開発のみ、-env フラグを使用）
3. シェルの環境変数に直接設定する

ClaudeとCursorでの使用方法

Jira MCPをClaudeとCursorで使用するには、Cursorの設定に構成を追加する必要があります。

手順1：Jira MCPをインストールする

上記のいずれかのインストール方法を選択します（Dockerを推奨）。

手順2：Cursorを設定する

1. Cursorを開きます。
2. 設定 > MCP > MCPサーバーを追加 を選択します。
3. 以下の構成を追加します。

オプションA：Dockerを使用する（推奨）

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Docker",
        "type": "docker",
        "command": "jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

オプションB：ローカルバイナリを使用する

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Local",
        "type": "local-binary",
        "path": "/usr/local/bin/jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

手順3：Claudeを使用する

これで、Claudeを通じてJira MCPを呼び出すことができます。例えば：

claude --mcp "jira" --command "search-issues" --arg "query:My Project"

🤝 貢献ガイド

このプロジェクトに貢献するには、GitHubリポジトリにアクセスし、貢献ガイドに従ってください。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。