MCP 服务器

mcp-sentry-ts

Enables querying and managing Sentry projects, issues, and events through natural language.

README

mcp-sentry

MCP-сервер для Sentry API в Cursor.

Требования: Node.js ≥ 22 (для будущей миграции на @sentry/api и CI). В репозитории есть .nvmrc — при работе из клона: nvm use.

Быстрый старт (npx, без клона)

Добавить в Cursor MCP (~/.cursor/mcp.json или project config):

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "github:CynepHy6/mcp-sentry#semver:^1"],
      "env": {
        "SENTRY_AUTH": "your_sentry_auth_token",
        "SENTRY_HOST": "https://sentry.example.com"
      }
    }
  }
}

Креды передаются только через env в MCP-конфиге

Переменная	Обязательна	По умолчанию
`SENTRY_AUTH`	да	—
`SENTRY_HOST`	нет	`https://sentry.io`
`PROTOCOL`	нет	`https`

Reload MCP в Cursor.

Версия в `args`

npx скачивает пакет из GitHub по адресу github:CynepHy6/mcp-sentry. Суффикс после # выбирает, какую версию установить:

каждый релиз помечен git-тегом вида v1.2.0 (история — в CHANGELOG.md);
npx сохраняет установку в ~/.npm/_npx/<hash>/, где hash зависит от строки в args.

Ref	Пример `args`	Когда использовать
диапазон `v1.x`	`["-y", "github:CynepHy6/mcp-sentry#semver:^1"]`	по умолчанию; при старте MCP подтягивает максимальный git-тег `v1.x`
конкретный тег	`["-y", "github:CynepHy6/mcp-sentry#v1.2.0"]`	зафиксировать версию
exact semver	`["-y", "github:CynepHy6/mcp-sentry#semver:1.2.0"]`	то же, через semver (ищет тег `v1.2.0`)

Обновление: с #semver:^1 новый релиз v1.x обычно подтягивается при старте MCP — reload Cursor чаще всего достаточно. С #v1.2.0 версия зафиксирована: смените ref или удалите sandbox. Если не помогло — npx clear-npx-cache и снова reload MCP.

Альтернатива: локальный клон

git clone https://github.com/CynepHy6/mcp-sentry.git
cd mcp-sentry
nvm use                # Node 22 из .nvmrc
cp .env.example .env   # заполнить креды
npm install && npm run compile

{
  "mcpServers": {
    "sentry": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-sentry/build/index.js"]
    }
  }
}

Креды можно держать в .env в корне клонированного репозитория.

Что умеет

просмотр проектов организации;
получение issue и событий по ID или URL;
извлечение контекста из событий;
экспорт событий и полей в локальные JSONL-файлы.

Документация

Файл	Для кого
AGENTS.md	разработка, workflows
CHANGELOG.md	история релизов
mcp-config.example.json	MCP-конфиг npx, диапазон `v1.x` (`#semver:^1`)