Skip to main content
Glama
Jira MCP Server for Cursor

Jira MCP Server for Cursor

by kornbed

カーソル用 Jira MCP サーバー

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

特徴

  • Jira チケットの一覧

  • チケットの詳細を見る

  • チケットのコメントを取得する

  • 新しいチケットを作成する

  • チケットにコメントを追加する

  • チケットステータスの更新

  • カーソル統合のための完全なMCPプロトコルサポート

Related MCP server: JIRA MCP Server

設定

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

npm install
  1. .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 トークンを取得するには:

  1. https://id.atlassian.com/manage/api-tokensにログインします。

  2. 「APIトークンを作成」をクリックします

  3. トークンをコピーして.envファイルに貼り付けます

発達

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

npm run dev

ビルドと実行

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

npm run build

サーバーを起動します。

npm start

カーソル統合

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

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

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

npm run build
  1. カーソルの設定を開きます。

    • カーソルメニューをクリックします

    • 「設定」を選択します(またはキーボードショートカットを使用します)

    • 「拡張機能」または「統合」セクションに移動します

  2. MCP 構成を追加します。

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

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

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

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

npm start
  1. カーソルの設定を開きます。

    • カーソルメニューをクリックします

    • 「設定」を選択します(またはキーボードショートカットを使用します)

    • 「拡張機能」または「統合」セクションに移動します

  2. 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
----------------------------------------

Available Tools

7 tools
add_commentC

Add a comment to a Jira ticket

Inputs: ticketId (required), comment (required).

create_ticketC

Create a new Jira ticket

Inputs: ticket (required).

get_commentsB

Get comments for a specific Jira ticket

Inputs: ticketId (required).

get_ticketC

Get details of a specific Jira ticket

Inputs: ticketId (required).

list_ticketsB

List Jira tickets assigned to you

Inputs: jql.

search_ticketsB

Search for tickets in specific projects using text search

Inputs: searchText (required), projectKeys (required), maxResults.

update_statusB

Update the status of a Jira ticket

Inputs: ticketId (required), status (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Jira operations: list_tickets vs. search_tickets differentiate between personal assignment and project-wide text search, while get_ticket vs. get_comments separate ticket details from comment retrieval. No tools appear to overlap in functionality, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., add_comment, create_ticket, get_comments). The verbs are appropriately chosen for each action (add, create, get, list, search, update), creating a predictable and readable naming convention throughout the set.

    Tool Count5/5

    With 7 tools, this server is well-scoped for Jira ticket management. Each tool earns its place by covering essential operations like creating, retrieving, listing, searching, updating status, and managing comments, without being overly sparse or bloated for the domain.

    Completeness4/5

    The tool set provides strong coverage for core Jira ticket workflows, including CRUD-like operations (create, get, list, update_status) and comment management. A minor gap exists in the lack of a tool to update ticket details beyond status (e.g., edit description or fields), but agents can work around this by creating new tickets or using comments.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
      11
      26
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.
      1
      -
    • F
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides tools for interacting with Jira. Enables Cursor and other MCP clients to fetch tickets, manage linked tickets, and update ticket status.
      3
      -