Skip to main content
Glama
deenesjakoruzh

JIRA MCP Server

by cosmix
npmGitHub
TypeScript
MIT License
152
20
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.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 .

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

How are these scores calculated?

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 и управления ими через протокол контекста модели, предлагая такие функции, как отслеживание взаимосвязей, очистка данных и контекстная аналитика для приложений ИИ.

  1. Поддержка Jira Cloud и Jira Server (центр обработки данных)
    1. Функции
      1. Предпосылки
        1. Переменные среды
          1. Установка и настройка
            1. Клонируйте репозиторий:
            2. Установите зависимости и соберите:
            3. Настройте MCP-сервер:
            4. Перезапустите сервер MCP.
          2. Разработка
            1. Доступные инструменты MCP
              1. поисковые\_вопросы
              2. получить\эпические\дети
              3. получить\_выпуск
              4. создать\_выпуск
              5. обновление\_выпуск
              6. добавить\_вложение
              7. добавить\_комментарий
            2. Функции очистки данных
              1. Технические подробности
                1. Обработка ошибок
                  1. ЛИЦЕНЗИЯ

                    Related Resources

                    Related MCP Servers

                    • Python Jira MCP Server

                      Chase-Bullock
                      -
                      security
                      F
                      license
                      -
                      quality
                      A 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 -
                      Python

                    • Jira MCP Server

                      ParasSolanki
                      A
                      security
                      A
                      license
                      A
                      quality
                      A 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 -
                      5
                      87
                      2
                      TypeScript
                      MIT License
                      • Apple

                    • Jira MCP Server

                      maximepeabody
                      -
                      security
                      A
                      license
                      -
                      quality
                      A 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 -
                      1
                      Python
                      Apache 2.0

                    • Jira MCP Toolset

                      tbreeding
                      -
                      security
                      A
                      license
                      -
                      quality
                      A 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 -
                      177
                      2
                      TypeScript
                      MIT License

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    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