カーソル用 Jira MCP サーバー

Jira と統合され、Cursor が Jira チケットと対話できるようにする TypeScript ベースの MCP サーバー。

特徴

Jira チケットの一覧
チケットの詳細を見る
チケットのコメントを取得する
新しいチケットを作成する
チケットにコメントを追加する
チケットステータスの更新
カーソル統合のための完全なMCPプロトコルサポート

設定

依存関係をインストールします:

npm install

.env.exampleに基づいて.envファイルを作成し、Jira の資格情報を入力します。

JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000

Jira API トークンを取得するには:

https://id.atlassian.com/manage/api-tokensにログインします。
「APIトークンを作成」をクリックします
トークンをコピーして.envファイルに貼り付けます

発達

開発サーバーを実行します。

npm run dev

ビルドと実行

プロジェクトをビルドします。

npm run build

サーバーを起動します。

npm start

カーソル統合

この MCP サーバーを Cursor で使用するには、次の 2 つのオプションがあります。

オプション 1: コマンドベースの統合 (推奨)

プロジェクトをビルドします。

npm run build

カーソルの設定を開きます。
- カーソルメニューをクリックします
- 「設定」を選択します（またはキーボードショートカットを使用します）
- 「拡張機能」または「統合」セクションに移動します
MCP 構成を追加します。

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-cursor/dist/server.js"]
    }
  }
}

/path/to/jira-mcp-cursorプロジェクトへの絶対パスに置き換えます。

オプション 2: HTTP ベースの統合 (代替)

MCP サーバーを起動します (まだ実行されていない場合)。

npm start

カーソルの設定を開きます。
- カーソルメニューをクリックします
- 「設定」を選択します（またはキーボードショートカットを使用します）
- 「拡張機能」または「統合」セクションに移動します
MCP 構成を追加します。

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000",
      "capabilities": [
        "list_tickets",
        "get_ticket",
        "get_comments",
        "create_ticket",
        "update_status",
        "add_comment"
      ]
    }
  }
}

カーソルでJiraを使用する

MCP サーバーを構成したら、Cursor で直接 Jira コマンドを使用できるようになります。

/jira list - チケットを一覧表示する
/jira view TICKET-123 - チケットの詳細を表示
/jira comments TICKET-123 - チケットコメントを取得する
/jira create - 新しいチケットを作成する
/jira comment TICKET-123 - コメントを追加
/jira status TICKET-123 - チケットステータスの更新

MCP プロトコルのサポート

サーバーは、カーソルに必要なモデルクライアントプロトコル (MCP) を実装します。

コマンドベースの統合のためのstdio通信
Jira 操作のためのツール登録

APIエンドポイント

チケット一覧

オプションで JQL クエリによってフィルタリングされた Jira チケットのリストを取得します。

エンドポイント: GET /api/tickets

クエリパラメータ:

パラメータ	タイプ	必須	説明
jql	弦	いいえ	チケットをフィルタリングするための Jira クエリ言語 (JQL) 文字列

リクエスト例:

GET /api/tickets?jql=project=TEST+AND+status=Open

応答例:

TEST-123: Example ticket (Open)
TEST-124: Another ticket (In Progress)

チケットを入手

特定のチケットに関する詳細情報を取得します。

エンドポイント: GET /api/tickets/:id

パスパラメータ:

パラメータ	タイプ	必須	説明
id	弦	はい	Jira チケット ID (例: TEST-123)

リクエスト例:

GET /api/tickets/TEST-123

応答例:

Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket description

チケットコメントを取得

特定のチケットのすべてのコメントを取得します。

エンドポイント: GET /api/tickets/:id/comments

パスパラメータ:

パラメータ	タイプ	必須	説明
id	弦	はい	Jira チケット ID (例: TEST-123)

リクエスト例:

GET /api/tickets/TEST-123/comments

応答例:

[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---

[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---

チケットを作成

新しい Jira チケットを作成します。

エンドポイント: POST /api/tickets

リクエスト本文:

パラメータ	タイプ	必須	説明
まとめ	弦	はい	チケットの概要
説明	弦	はい	チケットの説明
プロジェクトキー	弦	はい	プロジェクトキー（例：TEST）
問題タイプ	弦	はい	問題の種類（例：タスク、バグ）

リクエスト例:

POST /api/tickets
Content-Type: application/json

{
  "summary": "New feature request",
  "description": "Implement new functionality",
  "projectKey": "TEST",
  "issueType": "Task"
}

応答例:

Created ticket: TEST-124

コメントを追加

既存のチケットに新しいコメントを追加します。

エンドポイント: POST /api/tickets/:id/comments

パスパラメータ:

パラメータ	タイプ	必須	説明
id	弦	はい	Jira チケット ID (例: TEST-123)

リクエスト本文:

パラメータ	タイプ	必須	説明
体	弦	はい	コメントテキスト

リクエスト例:

POST /api/tickets/TEST-123/comments
Content-Type: application/json

{
  "body": "This is a new comment"
}

応答例:

Added comment to TEST-123

更新ステータス

既存のチケットのステータスを更新します。

エンドポイント: POST /api/tickets/:id/status

パスパラメータ:

パラメータ	タイプ	必須	説明
id	弦	はい	Jira チケット ID (例: TEST-123)

リクエスト本文:

パラメータ	タイプ	必須	説明
遷移ID	弦	はい	実行する遷移のID

リクエスト例:

POST /api/tickets/TEST-123/status
Content-Type: application/json

{
  "transitionId": "21"
}

応答例:

Updated status of TEST-123

チケットを検索

テキスト検索を使用して、指定されたプロジェクト全体のチケットを検索します。

エンドポイント: GET /api/tickets/search

クエリパラメータ:

パラメータ	タイプ	必須	説明
検索テキスト	弦	はい	チケット内で検索するテキスト
プロジェクトキー	弦	はい	検索するプロジェクトキーのコンマ区切りリスト
最大結果	番号	いいえ	返される結果の最大数（デフォルト: 50）

リクエスト例:

GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10

応答例:

Found 2 tickets matching "login bug"

[TEST] TEST-123: Login page bug
Status: Open (Updated: 3/20/2024, 10:00:00 AM)
Description:
Users unable to login using SSO
----------------------------------------

[PROD] PROD-456: Fix login performance
Status: In Progress (Updated: 3/19/2024, 3:30:00 PM)
Description:
Login page taking too long to load
----------------------------------------

Jira MCP Server for Cursor

Integrations

カーソル用 Jira MCP サーバー

特徴

設定

発達

ビルドと実行

カーソル統合

オプション 1: コマンドベースの統合 (推奨)

オプション 2: HTTP ベースの統合 (代替)

カーソルでJiraを使用する

MCP プロトコルのサポート

APIエンドポイント

チケット一覧

チケットを入手

チケットコメントを取得

チケットを作成

コメントを追加

更新ステータス

チケットを検索

Appeared in Searches