カーソル用 Jira MCP サーバー
Jira と統合され、Cursor が Jira チケットと対話できるようにする TypeScript ベースの MCP サーバー。
特徴
Jira チケットの一覧
チケットの詳細を見る
チケットのコメントを取得する
新しいチケットを作成する
チケットにコメントを追加する
チケットステータスの更新
カーソル統合のための完全なMCPプロトコルサポート
Related MCP server: Jira MCP Server
設定
依存関係をインストールします:
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=3000Jira API トークンを取得するには:
「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
----------------------------------------