-
securityF
license-
qualityA server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.
Last updated -
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 и метод аутентификации для выбранного типа.
Функции
Поиск проблем 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.jsonClaude 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 .
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Предоставляет интерфейс для доступа к данным JIRA и управления ими через протокол контекста модели, предлагая такие функции, как отслеживание взаимосвязей, очистка данных и контекстная аналитика для приложений ИИ.
- Поддержка Jira Cloud и Jira Server (центр обработки данных)
- Функции
- Предпосылки
- Переменные среды
- Установка и настройка
- Разработка
- Доступные инструменты MCP
- Функции очистки данных
- Технические подробности
- Обработка ошибок
- ЛИЦЕНЗИЯ
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.Last updated -5172MIT License
- -securityAlicense-qualityA Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.Last updated -1Apache 2.0
- -securityAlicense-qualityA collection of tools for interacting with Jira via the Model Context Protocol, providing core functionalities like fetching and analyzing issues, plus a guided Issue Creation Wizard.Last updated -522MIT License