Cursor Problems MCP

Расширение VS Code / Cursor, которое отдаёт панель Problems ассистентам через Model Context Protocol по Streamable HTTP.

English version: README.en.md

Зачем

Ассистенту нужен тот же список проблем, что видит человек в панели Problems: структурно, с фильтрами и контекстом кода, без ручного копирования из IDE.

Возможности

• Живые diagnostics (error / warning / information / hint)
• Фильтры по severity, source, file glob, code, message regex
• Опциональный контекст соседних строк кода
• Сводки по группам
• Code actions
• MCP resources и prompts

Установка

Вариант A. Промпт для Cursor Agent

Скопируй prompts/install-in-cursor.md в чат агента. Он клонирует/обновит репозиторий, соберёт VSIX, поставит zemecom.cursor-problems-mcp, уберёт конфликтующий Marketplace Problems Pipe и пропишет .cursor/mcp.json.

Английская копия промпта: prompts/install-in-cursor.en.md

Вариант B. Локальный checkout

npm install
npm run install:cursor

# сразу записать MCP-конфиг для workspace:
CURSOR_WORKSPACE="/absolute/path/to/workspace" npm run install:cursor

Если порт :3030 уже занят другим Problems MCP, останови его или смени cursorProblemsMcp.httpPort.

После установки

1. Developer: Reload Window или reload MCP servers.
2. Проверь, что доступны tools get_problems / get_problem_summary.
3. В workspace должен быть .cursor/mcp.json:

{
  "mcpServers": {
    "cursor-problems-mcp": {
      "url": "http://127.0.0.1:3030/mcp"
    }
  }
}

Хелпер в Command Palette: Cursor Problems MCP: Copy MCP Server Configuration.

MCP tools

Tool	Описание
get_problems	Запрос diagnostics с фильтрами, сортировкой, пагинацией и опциональным контекстом
get_file_problems	Markdown-отчёт по одному файлу
get_problem_summary	Сводка по severity / source / file / workspace
get_code_actions	Quick fixes для URI / позиции

MCP resources

URI	Описание
problems://all	Все diagnostics в JSON
problems://summary	Сводка в JSON
problems://errors	Только errors
problems://file/{path}	Diagnostics для относительного пути

MCP prompts

Prompt	Описание
fix-all-errors	Промпт на массовое исправление ошибок workspace
explain-error	Разбор одного diagnostic по diagnosticId

Настройки

Имена ключей как в package.json, секция cursorProblemsMcp.*:

Setting	Default	Описание
enabled	true	Включить расширение
autoStart	true	Поднять HTTP-сервер при activate
httpHost	127.0.0.1	Адрес bind
httpPort	3030	Порт
includeSources	[]	Allow-list источников diagnostics
excludeSources	[]	Deny-list источников diagnostics
maxDiagnosticsPerFile	100	Лимит на файл
contextLines	3	Радиус контекста по умолчанию
enableCodeActions	true	Отдавать get_code_actions
logLevel	info	Уровень лога

Разработка

Для правки самого расширения:

npm install
npm run typecheck
npm run test
npm run build
npm run watch

Отладка: открой эту папку в Cursor/VS Code и нажми F5 (Extension Development Host), либо собери VSIX через npm run package.

Связь с Problems Pipe и лицензия

Это независимый MIT-rewrite, а не официальный fork Problems Pipe. Upstream на GitHub сейчас недоступен, поэтому репозиторий отдельный; MCP-поверхность совместима, extension id свой: zemecom.cursor-problems-mcp.

MIT. В copyright указаны этот rewrite (zemecom, 2026) и оригинальная работа Problems Pipe (2025).