Skip to main content
Glama
Jira MCP Server for Cursor

Jira MCP Server for Cursor

by kornbed

Сервер Jira MCP для курсора

значок кузнецаСервер MCP на базе TypeScript, который интегрируется с Jira, позволяя Cursor взаимодействовать с тикетами Jira.

Функции

  • Список тикетов Jira

  • Получить информацию о билете

  • Получить комментарии к билету

  • Создать новые тикеты

  • Добавить комментарии к тикетам

  • Обновить статус тикета

  • Полная поддержка протокола MCP для интеграции курсора

Related MCP server: JIRA MCP Server

Настраивать

Установка через Smithery

Чтобы автоматически установить Jira MCP Server для Cursor for Claude Desktop через Smithery :

npx -y @smithery/cli install @kornbed/jira-mcp-server --client claude
  1. Установить зависимости:

npm install
  1. Создайте файл .env на основе .env.example и заполните свои учетные данные 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, у вас есть два варианта:

Вариант 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 вы можете использовать команды Jira непосредственно в Cursor:

  • /jira list — список ваших тикетов

  • /jira view TICKET-123 - Просмотреть детали билета

  • /jira comments TICKET-123 - Получить комментарии к тикетам

  • /jira create — Создать новый тикет

  • /jira comment TICKET-123 — Добавить комментарий

  • /jira status TICKET-123 — Обновить статус тикета

Поддержка протокола MCP

Сервер реализует протокол Model-Client-Protocol (MCP), требуемый Cursor:

  • Stdio-коммуникация для интеграции на основе команд

  • Регистрация инструмента для операций Jira

Конечные точки API

Список билетов

Извлекает список тикетов Jira, при необходимости отфильтрованный с помощью запроса JQL.

Конечная точка: GET /api/tickets

Параметры запроса:

Параметр

Тип

Необходимый

Описание

jql

нить

Нет

Строка Jira Query Language (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

Параметры пути:

Параметр

Тип

Необходимый

Описание

идентификатор

нить

Да

Идентификатор тикета Jira (например, 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

Параметры пути:

Параметр

Тип

Необходимый

Описание

идентификатор

нить

Да

Идентификатор тикета Jira (например, 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

Текст запроса:

Параметр

Тип

Необходимый

Описание

краткое содержание

нить

Да

Краткое описание билета

описание

нить

Да

Описание билета

проектКлюч

нить

Да

Ключ проекта (например, ТЕСТ)

issueType

нить

Да

Тип проблемы (например, Задача, Ошибка)

Пример запроса:

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

Параметры пути:

Параметр

Тип

Необходимый

Описание

идентификатор

нить

Да

Идентификатор тикета Jira (например, 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

Параметры пути:

Параметр

Тип

Необходимый

Описание

идентификатор

нить

Да

Идентификатор тикета Jira (например, TEST-123)

Текст запроса:

Параметр

Тип

Необходимый

Описание

transitionId

нить

Да

Идентификатор перехода для выполнения

Пример запроса:

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

{
  "transitionId": "21"
}

Пример ответа:

Updated status of TEST-123

Поиск билетов

Поиск билетов по указанным проектам с помощью текстового поиска.

Конечная точка: GET /api/tickets/search

Параметры запроса:

Параметр

Тип

Необходимый

Описание

поискТекст

нить

Да

Текст для поиска в билетах

проектKeys

нить

Да

Список ключей проекта, разделенных запятыми, для поиска

maxResults

число

Нет

Максимальное количество возвращаемых результатов (по умолчанию: 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
      -