Сервер 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

2. Создайте файл .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

2. Откройте настройки курсора:

   • Нажмите на меню курсора.

   • Выберите «Настройки» (или используйте сочетание клавиш)

   • Перейдите в раздел «Расширения» или «Интеграции».

3. Добавьте конфигурацию 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

2. Откройте настройки курсора:

   • Нажмите на меню курсора.

   • Выберите «Настройки» (или используйте сочетание клавиш)

   • Перейдите в раздел «Расширения» или «Интеграции».

3. Добавьте конфигурацию 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

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

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

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

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

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

Получить билет

Получает подробную информацию о конкретном тикете.

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

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

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

GET /api/tickets/TEST-123

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

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

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

Извлекает все комментарии для определенного тикета.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "transitionId": "21"
}

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

Updated status of TEST-123

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

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

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

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

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

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