jira-context-mcp

jira-context-mcp — это MCP-сервер для промышленного использования, который извлекает структурированный контекст задачи Jira из URL-адреса Jira. Он разработан для агентов по написанию кода, таких как Codex и Claude Code, чтобы они могли быстро понять суть задачи и контекст реализации.

Что делает этот сервер

• Предоставляет один инструмент MCP: get_jira_issue_from_url

• Проверяет, что входной URL принадлежит вашему JIRA_BASE_URL

• Извлекает ключ задачи Jira из различных форматов URL Jira

• Вызывает REST API Jira Cloud:

  • GET /rest/api/3/issue/{issueIdOrKey}?expand=names,renderedFields

• Преобразует форматированный текст Jira (Atlassian Document Format) в обычный текст

• Возвращает лаконичный, структурированный контекст задачи, удобный для агентов

Related MCP server: JIRA MCP Server

Поддерживаемые типы задач Jira

Этот сервер не зависит от типа задачи. Он работает с любым типом задач Jira, включая:

• Ошибки (Bug)

• Запросы на добавление функций (Feature request)

• Задачи (Task)

• Истории (Story)

• Эпики (Epic)

• Требования (Requirement)

• Улучшения (Improvement)

• Заявки в поддержку (Support ticket)

• Пользовательские типы задач

Необходимые переменные окружения

• JIRA_EMAIL: Email учетной записи Jira

• JIRA_API_TOKEN: API-токен Jira

• JIRA_BASE_URL: URL клиента Jira Cloud (например, https://your-domain.atlassian.net)

Команды для быстрой настройки

Codex (без глобальной установки)

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Claude Code (без глобальной установки)

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Опционально: сначала установите глобально

npm install -g github:TastyHeadphones/jira-context-mcp

Затем добавьте с помощью локального бинарного файла:

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

Инструмент

get_jira_issue_from_url

Входные данные:

{
  "url": "string"
}

Примеры поддерживаемых URL:

• ${JIRA_BASE_URL}/browse/ABC-123

• ${JIRA_BASE_URL}/jira/software/projects/ABC/boards/1/backlog?selectedIssue=ABC-123

• Любой URL Jira в рамках JIRA_BASE_URL, содержащий ключ задачи, например ABC-123

Возвращаемые структурированные данные включают:

• issueKey, issueUrl, summary

• description (по возможности в виде обычного текста)

• issueType, status, statusCategory, priority

• assignee, reporter

• labels, components

• fixVersions, affectedVersions

• created, updated, dueDate

• parent, epic

• subtasks, linkedIssues

• attachments (только метаданные)

• comments (последние 10)

• acceptanceCriteria (извлечение из описания/пользовательских полей по мере возможности)

• customFields (непустые, нормализованные, читаемые человеком)

Создание API-токена Jira

1. Откройте настройки API-токенов Atlassian.

2. Нажмите Create API token (Создать API-токен).

3. Назовите токен и скопируйте его.

4. Используйте это значение для JIRA_API_TOKEN.

Локальный запуск

1. Установите зависимости:

npm install

2. Установите переменные окружения (например, через .env в вашей оболочке/сессии).

3. Соберите проект:

npm run build

4. Запустите:

npm start

Режим разработки:

npm run dev

Примеры конфигурации MCP

Используйте эту запись сервера в конфигурации вашего клиента MCP:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-context-mcp/dist/index.js"],
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-token",
        "JIRA_BASE_URL": "https://your-domain.atlassian.net"
      }
    }
  }
}

Пример конфигурации MCP для Claude Code

Используйте тот же JSON-блок выше в файле конфигурации сервера MCP для Claude Code.

Пример конфигурации MCP для Codex

Используйте тот же JSON-блок выше в файле конфигурации сервера MCP для Codex.

Пример вызова инструмента

{
  "name": "get_jira_issue_from_url",
  "arguments": {
    "url": "https://your-domain.atlassian.net/browse/ABC-123"
  }
}

Пример вывода

{
  "issueKey": "ABC-123",
  "issueUrl": "https://your-domain.atlassian.net/browse/ABC-123",
  "summary": "Prevent duplicate webhook retries",
  "description": "As a platform engineer, I need retry deduplication ...",
  "acceptanceCriteria": "- Duplicate deliveries are ignored\n- Metrics include dropped duplicates",
  "issueType": "Story",
  "status": "In Progress",
  "statusCategory": "In Progress",
  "priority": "High",
  "assignee": {
    "accountId": "5b10ac8d82e05b22cc7d4ef5",
    "displayName": "Alex Example",
    "emailAddress": null,
    "active": true
  },
  "labels": ["webhook", "idempotency"],
  "components": ["API"],
  "fixVersions": ["2026.05"],
  "affectedVersions": ["2026.04"],
  "subtasks": [],
  "linkedIssues": [],
  "attachments": [],
  "comments": [],
  "customFields": []
}

Примечания по безопасности

• Храните JIRA_API_TOKEN в секрете. Никогда не добавляйте его в систему контроля версий.

• Используйте для учетной записи, привязанной к токену, минимально необходимые права доступа в Jira.

• Этот сервер только извлекает данные задач и метаданные вложений; он не скачивает файлы вложений.

• Проверка URL отклоняет адреса вне вашего настроенного JIRA_BASE_URL.