JIRA MCP-сервер

Реализация сервера Model Context Protocol (MCP), которая обеспечивает доступ к данным JIRA с отслеживанием взаимосвязей, оптимизированной полезной нагрузкой данных и очисткой данных для окон контекста ИИ.

ℹ️ Для Confluence есть отдельный MCP-сервер

Поддержка Jira Cloud и Jira Server (центр обработки данных)

Этот сервер MCP поддерживает как экземпляры Jira Cloud , так и Jira Server (Data Center) . Вы можете выбрать, какой тип использовать, установив переменную среды JIRA_TYPE :

• cloud (по умолчанию): для Jira Cloud (размещено Atlassian)

• server : Для Jira Server/Data Center (размещенный самостоятельно)

Сервер автоматически будет использовать правильную версию API и метод аутентификации для выбранного типа.

Related MCP server: Jira MCP Server

Функции

• Поиск проблем JIRA с использованием JQL (максимум 50 результатов на запрос)

• Извлечение эпических дочерних элементов с историей комментариев и оптимизированными полезными нагрузками (максимум 100 проблем на запрос)

• Получите подробную информацию о проблеме, включая комментарии и связанные с ней вопросы

• Создание, обновление и управление задачами JIRA

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

• Извлечение упоминаний проблем из формата документов Atlassian

• Отслеживать взаимосвязи проблем (упоминания, ссылки, родительские/дочерние, эпические произведения)

• Очищайте и преобразуйте насыщенный контент JIRA для повышения эффективности контекста ИИ

• Поддержка вложений файлов с безопасной обработкой многокомпонентной загрузки

• Поддерживает API Jira Cloud и Jira Server (Data Center)

Предпосылки

• Бан (v1.0.0 или выше)

• Учетная запись JIRA с доступом к API

Переменные среды

JIRA_API_TOKEN=your_api_token
JIRA_BASE_URL=your_jira_instance_url  # e.g., https://your-domain.atlassian.net
JIRA_USER_EMAIL=your_email
JIRA_TYPE=cloud   # or 'server' for Jira Server/Data Center (optional, defaults to 'cloud')

Установка и настройка

1. Клонируйте репозиторий:

git clone [repository-url]
cd jira-mcp

2. Установите зависимости и соберите:

bun install
bun run build

3. Настройте MCP-сервер:

Отредактируйте соответствующий файл конфигурации:

macOS:

• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Рабочий стол Клода: ~/Library/Application Support/Claude/claude_desktop_config.json

Окна:

• Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

• Рабочий стол Клода: %APPDATA%\Claude Desktop\claude_desktop_config.json

Линукс:

• Клайн: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Claude Desktop: к сожалению, пока не существует

Добавьте следующую конфигурацию в объект mcpServers :

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_BASE_URL": "your_jira_instance_url",
        "JIRA_USER_EMAIL": "your_email",
        "JIRA_TYPE": "cloud"
      }
    }
  }
}

4. Перезапустите сервер MCP.

В настройках MCP Клайна перезапустите сервер MCP. Перезапустите Claude Desktop, чтобы загрузить новый сервер MCP.

Разработка

Проведите тесты:

bun test

Режим наблюдения за развитием:

bun run dev

Для перестройки после изменений:

bun run build

Доступные инструменты MCP

поисковые_вопросы

Поиск проблем JIRA с использованием JQL. Возвращает до 50 результатов на запрос.

Схема ввода:

{
  searchString: string; // JQL search string
}

получить_эпические_дети

Получить все дочерние проблемы в эпопее, включая их комментарии и данные об отношениях. Ограничено 100 проблемами на запрос.

Схема ввода:

{
  epicKey: string; // The key of the epic issue
}

получить_выпуск

Получите подробную информацию о конкретной задаче JIRA, включая комментарии и все взаимосвязи.

Схема ввода:

{
  issueId: string; // The ID or key of the JIRA issue
}

создать_выпуск

Создайте новую задачу JIRA с указанными полями.

Схема ввода:

{
  projectKey: string, // The project key where the issue will be created
  issueType: string, // The type of issue (e.g., "Bug", "Story", "Task")
  summary: string, // The issue summary/title
  description?: string, // Optional issue description
  fields?: { // Optional additional fields
    [key: string]: any
  }
}

обновление_выпуск

Обновление полей существующей задачи JIRA.

Схема ввода:

{
  issueKey: string, // The key of the issue to update
  fields: { // Fields to update
    [key: string]: any
  }
}

добавить_вложение

Добавьте прикрепленный файл к задаче JIRA.

Схема ввода:

{
  issueKey: string, // The key of the issue
  fileContent: string, // Base64 encoded file content
  filename: string // Name of the file to be attached
}

добавить_комментарий

Добавить комментарий к задаче JIRA. Принимает простой текст и преобразует его в требуемый формат документа Atlassian внутри.

Схема ввода:

{
  issueIdOrKey: string, // The ID or key of the issue to add the comment to
  body: string // The content of the comment (plain text)
}

Функции очистки данных

• Извлекает текст из формата документов Atlassian

• Отслеживает упоминания проблемы в описаниях и комментариях

• Поддерживает формальные связи между проблемами и типами отношений

• Сохраняет отношения родитель/ребенок

• Отслеживает эпические ассоциации

• Включает историю комментариев с информацией об авторе

• Удаляет ненужные метаданные из ответов

• Рекурсивно обрабатывает узлы контента на предмет упоминаний

• Удаляет дубликаты упоминаний о проблемах

Технические подробности

• Создано с помощью TypeScript в строгом режиме

• Использует среду выполнения Bun для повышения производительности

• Vite для оптимизированных сборок

• Использует JIRA REST API v3

• Базовая аутентификация с помощью API-токенов

• Пакетные запросы API для связанных данных

• Оптимизированные полезные данные ответа для окон контекста ИИ

• Эффективное преобразование сложных структур Atlassian

• Надежная обработка ошибок

• Соображения по ограничению скорости

• Максимальные ограничения:

  • Результаты поиска: 50 вопросов по запросу

  • Эпические дети: 100 выпусков по запросу

• Поддержка многокомпонентных данных форм для защищенных вложений файлов

• Автоматическое определение и проверка типа контента

Обработка ошибок

Сервер реализует комплексную стратегию обработки ошибок:

• Обнаружение сетевых ошибок и отправка соответствующих сообщений

• Обработка кодов состояния HTTP (особенно 404 для проблем)

• Подробные сообщения об ошибках с кодами состояния

• Подробная информация об ошибке выводится на консоль

• Проверка ввода всех параметров

• Безопасное распространение ошибок через протокол MCP

• Специализированная обработка распространенных ошибок API JIRA

• Проверка Base64 для вложений

• Обработка сбоев многокомпонентных запросов

• Обнаружение ограничения скорости

• Проверка параметров вложения

ЛИЦЕНЗИЯ

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENCE .