Skip to main content
Glama
deenesjakoruzh

JIRA MCP Server

by cosmix
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote
MIT License
156
22

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 .

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cosmix/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server