Сервер JIRA MCP

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

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

Функции

Поиск проблем JIRA с использованием JQL (максимум 50 результатов на запрос)
Извлечение эпических дочерних элементов с историей комментариев и оптимизированными полезными нагрузками (максимум 100 проблем на запрос)
Получите подробную информацию о проблеме, включая комментарии и связанные с ней вопросы
Создание, обновление и управление задачами JIRA
Добавить комментарии к проблемам
Извлечение упоминаний проблем из формата документов Atlassian
Отслеживать взаимосвязи проблем (упоминания, ссылки, родительские/дочерние, эпические произведения)
Очищайте и преобразуйте насыщенный контент JIRA для повышения эффективности контекста ИИ
Поддержка вложений файлов с безопасной обработкой многокомпонентной загрузки

Предпосылки

Бан (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

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

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

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 .

JIRA MCP Server

Integrations