MCP JIRA Server

Интеграция 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 - Автоматически создавать ежедневные стендап-отчеты

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

• Отслеживание прогресса спринта с помощью визуальных индикаторов
• Анализ рабочей нагрузки команды и планирование мощностей
• Автоматизированная генерация ежедневных стендап-отчетов
• Создание проблем с правильной расстановкой приоритетов
• Умный поиск и фильтрация проблем

Требования

• 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 — см. файл ЛИЦЕНЗИЯ