Jira-Context-MCP

by rahulthedevil
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .ENV for configuration management, allowing users to set up Jira connection details including base URL, username, and API token.

  • Enables GitHub integration for code analysis and workflow management as evidenced by the CodeQL badge and GitHub Actions workflow reference.

  • Integrates with Jira's API to fetch issue details, retrieve assigned tickets, filter issues by type, list projects, get issue types, and track recent changes in tickets, enabling AI-powered Jira ticket management directly within Cursor IDE.

Jira コンテキスト MCP

Jira のモデル コンテキスト プロトコル (MCP) 実装により、次のことが可能になります。

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

設定

前提条件

  • Node.js 20.17.0 以上
  • APIアクセス権限を持つJiraアカウント
  • Jira API トークン ( Atlassian API トークンで生成できます)

インストール

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. Jira の詳細を使用して.envファイルを編集します。
    JIRA_BASE_URL=https://your-domain.atlassian.net JIRA_USERNAME=your-email@example.com 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

カーソルで接続する

  1. カーソルでコマンドパレットを開きます(Ctrl+Shift+P または Cmd+Shift+P)
  2. **「MCPサーバーに接続」**と入力します
  3. **「MCPサーバーに接続」**を選択します
  4. サーバーのURLを入力します(デフォルト: http://localhost:3000/sse

利用可能なツール

接続すると、カーソルで次のツールを使用できるようになります。

1. Jira の問題の詳細を取得する

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

/get_issue issueKey:PROJECT-123

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

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

/get_assigned_issues projectKey:PROJECT maxResults:10

3. 種類別に問題を取得する

問題をタイプ別(バグ、ストーリー、エピックなど)にフィルタリングします。

/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がすべてのオープンチケットを取得する
手間をかけずに整理整頓しましょう!

🐛 「バグや変更リクエストのみをフィルタリングして修正する」
→ AIがそれらを識別し、カーソルに解決を指示します
自動化により問題をより早く解決しましょう!

「自分に割り当てられたすべてのチケットを見つけて修正する」
→ 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. カーソルを指示:
    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メソッドに新しいツールの定義を追加します。

ライセンス

マサチューセッツ工科大学

著者

ラフル・デイ - @rahulthedevil

ID: a8ob8depqc