Jira Context MCP

Jira Context MCP

Jira 向けの Model Context Protocol (MCP) 実装です。次のことができます。

• Jira チケットのリンクを入力して課題の詳細を取得し、Cursor に修正を指示する
• 指定した Jira プロジェクト内で自分に割り当てられたすべてのチケットを取得する
• 特定の課題タイプに基づいて Jira の課題をフィルタリングし、Cursor に自動的に解決を指示する
• Jira の API とシームレスに連携して、自動化と効率化を実現する

セットアップ

前提条件

• Node.js 20.17.0 以降
• API アクセス権を持つ Jira アカウント
• Jira API トークン（Atlassian API Tokens で生成できます）

インストール

Smithery 経由でのインストール

Smithery を使用して、Claude Desktop 用の Jira Context MCP を自動的にインストールするには、次のコマンドを実行します。

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

手動でのインストール

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

   git clone https://github.com/yourusername/Jira-Context-MCP.git
   cd Jira-Context-MCP
   

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

   npm install
   # or if you use pnpm
   pnpm install
   

3. サンプルを基に .env ファイルを作成します：

   cp .env.example .env
   

4. .env ファイルを編集して Jira の詳細を設定します：

   JIRA_BASE_URL=https://your-domain.atlassian.net
   [email protected]
   JIRA_API_TOKEN=your-api-token-here
   HTTP_PORT=3000
   

ビルド

次のコマンドでプロジェクトをビルドします：

npm run build
# or
pnpm build

使用方法

サーバーの起動

HTTP サーバーを起動します：

npm start
# or
pnpm start

または CLI モードを使用します：

npm run start:cli
# or
pnpm start:cli

Cursor との接続

1. Cursor でコマンドパレットを開きます（Ctrl+Shift+P または Cmd+Shift+P）
2. 「Connect to MCP Server」 と入力します
3. 「Connect to MCP Server」 を選択します
4. サーバー URL を入力します（デフォルト： http://localhost:3000/sse）

利用可能なツール

接続すると、Cursor で以下のツールを使用できます。

1. Jira 課題の詳細を取得

特定の Jira 課題に関する詳細情報を取得します：

/get_issue issueKey:PROJECT-123

2. 割り当てられた課題を取得

特定のプロジェクトで自分に割り当てられた課題を取得します：

/get_assigned_issues projectKey:PROJECT maxResults:10

3. タイプ別に課題を取得

タイプ別に課題をフィルタリングします（Bug、Story、Epic など）：

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. プロジェクトを取得

利用可能なすべてのプロジェクトを一覧表示します：

/get_projects

5. 課題タイプを取得

利用可能なすべての課題タイプを一覧表示します：

/get_issue_types

6. 最近のチケット変更を取得

プロジェクト内で指定した期間（例：過去 7 日間）にチケットに行われた変更を取得します：

/get_recent_changes projectKey:PROJECT maxDays:7

コマンド例

🚀 Jira MCP Server + Cursor IDE = AI を活用した Jira アシスタント！ 開発者の仕事をよりスマートにする方法をご紹介します。

📂 「アクセス権を持つすべての Jira プロジェクトを一覧表示して」
→ AI が利用可能なすべてのプロジェクトを即座に取得します
もう手動で探し回る必要はありません！

📋 「PROJECT のすべての課題を一覧表示して」
→ AI がすべての未解決チケットを取得します
手間なく整理整頓できます！

🐛 「Bugs または Change Requests だけをフィルタリングして修正して」
→ AI がそれらを特定し、Cursor に解決を指示します
自動化で課題をより迅速に修正できます！

✅ 「自分に割り当てられたすべてのチケットを見つけて修正して」
→ AI がタスクを取得し、Cursor に処理させます
手間をかけずに仕事を把握できます！

🔍 「Jira 課題 PROJECT-123 の詳細を取得して」
→ AI が完全な課題情報を数秒で取得します
もうタブを切り替える必要はありません！

📊 「PROJECT で過去 7 日間にチケットに何が変更された？」
→ AI が最近の更新を追跡し、主要な変更をハイライトします
もうチケット履歴を手動で確認する必要はありません！

🔥 TL;DR: あなたの AI が Jira + Cursor を話せるようになりました！プロジェクトの取得、課題のフィルタリング、変更の追跡、バグの修正を、すべて IDE 内で行えます。
バックログからバグ修正まで、MCP Server が Jira をあなたのために機能させます！

ワークフロー例

特定のバグを修正する

1. Cursor で Jira MCP サーバーに接続します。
2. 課題の詳細を取得します:

   /get_issue issueKey:PROJECT-123
   

3. 課題の詳細を確認し、Cursor に修正を指示します:

   Fix the bug described in PROJECT-123
   

割り当てられた課題に取り組む

1. Cursor で Jira MCP サーバーに接続します。
2. 自分に割り当てられた課題を取得します:

   /get_assigned_issues projectKey:PROJECT
   

3. いずれかの課題について Cursor に支援を依頼します:

   Help me solve the first issue in my assigned list
   

プロジェクト内のすべてのバグを修正する

1. Cursor で Jira MCP サーバーに接続します。
2. すべてのバグ課題を取得します:

   /get_issues_by_type issueType:Bug projectKey:PROJECT
   

3. Cursor に指示します:

   Help me fix these bugs one by one
   

最近の変更をレビューする

1. Cursor で Jira MCP サーバーに接続します。
2. 最近のチケット更新を取得します:

   /get_recent_changes projectKey:PROJECT maxDays:7
   

3. 変更をレビューして、修正状況を常に把握します。

開発

プロジェクト構成

• src/ - ソースコード
  • services/ - Jira API サービス
  • types/ - TypeScript の型定義
  • utils/ - ユーティリティ関数
  • server.ts - MCP サーバーの実装
  • index.ts - アプリケーションのエントリーポイント
  • cli.ts - CLI のエントリーポイント

新しいツールの追加

新しいツールを追加するには、src/server.ts ファイルを編集し、registerTools メソッドに新しいツール定義を追加します。

ライセンス

MIT

作者

Rahul Dey - @rahulthedevil