Интеграция MCP Jira

Простой сервер Model Context Protocol (MCP) для Jira, который позволяет специалистам LLM выступать в качестве менеджеров проектов и личных помощников для команд, использующих Jira.

Функции

Основные инструменты MCP

• create_issue — создание новых задач Jira с правильным форматированием

• search_issues - Поиск проблем с использованием JQL с интеллектуальным форматированием

• get_sprint_status — Получайте подробные отчеты о ходе спринта

• get_team_workload — Анализ нагрузки и возможностей членов команды

• generate_standup_report - Автоматически создавать ежедневные стендап-отчеты

Возможности управления проектами

• Отслеживание прогресса спринта с помощью визуальных индикаторов

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

• Автоматизированная генерация ежедневных стендап-отчетов

• Создание проблем с правильной расстановкой приоритетов

• Умный поиск и фильтрация проблем

Related MCP server: JIRA MCP Server

Требования

• Python 3.8 или выше

• Аккаунт Jira с токеном API

• MCP-совместимый клиент (например, Claude Desktop)

Быстрая настройка

1. Клонировать и установить :

2. Настройте учетные данные Jira в .env :

3. Запустите сервер MCP :

Примеры использования

Создание проблем

«Создать ошибку с высоким приоритетом для системы входа, которая работает неправильно»

• Автоматически назначает правильный тип проблемы, приоритет и форматирование

Управление спринтом

«Каков текущий статус нашего спринта?»

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

Управление командой

«Покажите мне рабочую нагрузку команды для john.doe, jane.smith, mike.wilson»

• Анализирует емкость и обеспечивает распределение рабочей нагрузки

Ежедневные стендапы

«Создать сегодняшний стендап-отчет»

• Создает форматированный отчет с завершенными, выполняемыми и заблокированными элементами.

Интеграция МКП

С Клодом Десктопом

Добавьте в ваш claude_desktop_config.json :

С другими клиентами MCP

Сервер следует стандартному протоколу MCP и работает с любым MCP-совместимым клиентом.

Конфигурация

Требуемые переменные среды

• JIRA_URL — URL-адрес вашего экземпляра Jira.

• JIRA_USERNAME — Ваше имя пользователя/адрес электронной почты Jira

• JIRA_API_TOKEN — ваш токен API Jira.

• PROJECT_KEY — ключ проекта по умолчанию для операций

Дополнительные настройки

• DEFAULT_BOARD_ID — Доска по умолчанию для спринтерских операций

• DEBUG_MODE — включить ведение журнала отладки (по умолчанию: false)

• LOG_LEVEL — уровень ведения журнала (по умолчанию: INFO)

Получение токена API Jira

1. Перейдите в настройки учетной записи Atlassian.

2. Нажмите «Создать токен API».

3. Дайте ему имя и скопируйте токен.

4. Используйте свой адрес электронной почты в качестве имени пользователя и токен в качестве пароля.

Архитектура

В данной реализации приоритет отдается простоте:

• Единый файл сервера MCP — все инструменты в одном месте

• Стандартный протокол MCP — использует официальный MCP SDK

• Расширенное форматирование — создает красивые, читабельные отчеты.

• Обработка ошибок — Грамотная обработка проблем API Jira

• Асинхронная поддержка — быстрые и отзывчивые операции

Поиск неисправностей

Распространенные проблемы

1. «Активный спринт не найден»

   • Убедитесь, что на вашей доске есть активный спринт

   • Проверьте правильность установки DEFAULT_BOARD_ID

2. Ошибки аутентификации

   • Проверьте правильность вашего API-токена

   • Убедитесь, что ваше имя пользователя совпадает с вашим адресом электронной почты.

3. Ошибки разрешения

   • Убедитесь, что у вашего пользователя Jira есть соответствующие разрешения для проекта.

   • Проверьте, что ключ проекта существует и у вас есть доступ

Режим отладки

Установите DEBUG_MODE=true в файле .env для подробного протоколирования.

Внося вклад

1. Форк репозитория

2. Внесите изменения

3. Тестируйте с вашим экземпляром Jira

4. Отправить запрос на извлечение

Лицензия

Лицензия MIT — см. файл ЛИЦЕНЗИЯ