Никита Орлов
@orlov_devПроверил редактор @nepost

СтатьяГайд

Как исправить ошибку stdio MCP-сервера в Cursor IDE

Автор отметил, что материал написан или существенно правлен с помощью ИИ (gemini-2.5-flash).

Симптом: ошибка stdio connection при старте MCP-сервера в Cursor

Вчера агент в репе попытался поднять локальный MCP-сервер, но Cursor выдал ошибку подключения по протоколу stdio. Процесс падает сразу при инициализации, в логах висящий node.js с кодом выхода 1 или ENOENT.

По официальной документации Cursor, интеграция Model Context Protocol работает через запуск дочерних процессов на машине разработчика. Если транспорт stdio не может связаться с бинарником, IDE показывает красный статус сервера.

  1. Симптом: статус MCP-сервера в настройках Cursor меняется на «Failed to start» или «Disconnected».
  2. Ошибка в логах: spawn node ENOENT или сброс потока ввода-вывода.
Cursor Documentation: Model Context Protocol: https://docs.cursor.com/context/model-context-protocol

Предварительные требования и версия среды

Для работы MCP-серверов в Cursor требуется актуальная версия редактора и установленная среда выполнения Node.js (рекомендуется LTS версия от 18 и выше).

Проверьте, что нужный пакет установлен глобально или локально в проекте, а путь к нему доступен из терминала операционной системы.

  1. Cursor IDE версии 0.45 или выше.
  2. Node.js и npm в системном PATH.

Шаг 1: Проверка и исправление конфига mcp.json

Частая причина падения stdio — относительные пути в конфиге Cursor или неверно указанный интерпретатор. Конфигурационный файл MCP в Cursor обычно располагается в корне пользовательской директории или в настройках проекта.

Пример рабочего конфига требует абсолютных путей к исполняемому файлу node и скрипту сервера. Использование сокращений вроде ~ часто приводит к тому, что подпроцесс не может найти модуль.

  1. Откройте настройки MCP в Cursor (Settings -> Features -> MCP).
  2. Убедитесь, что ключи command и args содержат абсолютные пути.
Anthropic Model Context Protocol SDK for TypeScript: https://github.com/modelcontextprotocol/typescript-sdk

Шаг 2: Отладка передачи данных по протоколу stdio

Протокол stdio завязан на то, что сервер пишет JSON-RPC сообщения строго в стандартный вывод (stdout), а логи и отладочный вывод отправляет только в stderr. Если в коде вашего сервера есть неперехваченные `console.log`, они ломают JSON-RPC парсер в Cursor.

Вывод отладочной информации через `console.log` в stdout — гарантированный способ получить ошибку соединения.

  1. Замените все `console.log` в коде MCP-сервера на запись в файл или `console.error`.
  2. Проверьте работу сервера вручную через запуск команды из конфига в терминале.

Проверка результата и безопасный откат

После правки путей и очистки stdout перезапустите Cursor IDE или нажмите кнопку «Retry Connection» в панели MCP. Статус сервера должен смениться на зеленый (Connected).

Если сервер продолжает падать, верните резервную копию конфигурационного файла и временно отключите проблемный транспорт для продолжения работы с другими инструментами.

  1. Проверка статуса в интерфейсе Cursor.
  2. Откат изменений через восстановление исходного mcp.json из контроля версий.

Источники

Источник: https://docs.cursor.com/context/model-context-protocol

0
1

Комментарии (0)

Войдите, чтобы комментировать.

Без Plus — 5 комментариев в месяц. Мало слов — чистый воздух. Войти

Комментариев пока нет — будьте первым.

Ещё в теме «Код и разработка»

Похожие материалы и соседние разборы

Никита Орлов
Никита ОрловУровень Курсант

Симптом: Cursor IDE не видит локальный интерпретатор Python Симптом: при открытии проекта в Cursor IDE линтер ругается на отсутствие модулей, а в правом нижнем углу или через палитру команд не удается выбрать локальный интерпретатор из папки .venv. Поведение воспроизводится при открытии нового воркспейса на базе стандартного модуля venv или Poetry без явно прописанных путей в конфигурации рабочей зоны. Причина сбоя: расхождение путей в settings.json и workspace Поскольку Cursor построен на базе VS Code, он использует те же механизмы поиска интерпретаторов, но часто теряет контекст проекта из-за структуры вложенных папок или монорепозиториев. Если в настройках воркспейса жестко не зафиксирован путь к исполняемому файлу python, сканер окружения падает по таймауту или берет дефолтную системную версию. Фиксим через ручную правку settings.json

Показать полностью
0
3
Алина Ким
Алина КимУровень Курсант

Вводные данные: терминал против графического интерфейса Утром в понедельник хочется открыть проект и сразу начать править баги, а не настраивать окружение. Выбор стоит между Claude Code — консольной утилитой от Anthropic, работающей прямо в терминале, и Cursor — полноценным форком VS Code с глубокой интеграцией ИИ в интерфейс. Я так делаю в понедельник: если нужно быстро пройтись по старым скриптам через командную строку, я запускаю терминал. Если требуется перелопатить структуру крупного модуля с кучей открытых вкладок, удобнее визуальный интерфейс. Claude Code vs Cursor review: архитектура и первый запуск Claude Code запускается прямо в директории проекта через терминальную команду. Утилита сама читает структуру каталогов, выполняет тегирование и может запускать тесты через консоль. Модель управляется текстовыми запросами. Cursor требует

Показать полностью
0
3
Никита Орлов
Никита ОрловУровень Курсант

Входные данные и проблема подгонки результатов Сравнение ИИ агентов для кода часто страдает от одной проблемы: тесты пишутся под конкретную модель или промпт подгоняется под привычки ассистента. В итоге на бенчмарках всё зелёное, а на живом репозитории агент ломает соседние модули. Чтобы получить объективный срез, нужна строгая изоляция среды и зафиксированный срез кодовой базы. Ниже разнесена методика, опирающаяся на подходы SWE-bench и локальный запуск в изолированных контейнерах. Как проверить агентов на одном issue без подгонки результата Для чистоты эксперимента берётся один реальный закрытый issue из репозитория средней сложности на GitHub с понятным набором упавших тестов. Задача агента — устранить ошибку, не затронув остальную логику. Среда выполнения изолируется через Docker-контейнер с фиксированными зависимостями. Агент получает на

Показать полностью
0
2
Никита Орлов
Никита ОрловУровень Курсант

Как настроить MCP в Cursor: системные требования и версия Для работы Model Context Protocol в Cursor требуется версия редактора от 0.45 и выше, так как в ранних сборках поддержка MCP отсутствовала или работала нестабильно. В качестве хоста для серверов используется Node.js версии 18 и выше или Python 3.10+, в зависимости от выбранного транспорта. У меня в репозитории поднят сервер на TypeScript, поэтому в системе также должен быть установлен npx или ts-node. Официальная документация Cursor рекомендует проверять запуск через терминал перед тем, как прописывать конфигурацию в редактор. Где лежит файл конфигурации и как добавить сервер Настройки MCP в Cursor хранятся в корневом конфигурационном файле редактора. Добраться до него можно через интерфейс: Settings -> Features -> Model Context Protocol, либо открыв файл mcp.json напрямую в системной

Показать полностью
0
0
Павел Дронов
Павел ДроновУровень Курсант

Симптом: почему Cursor AI перестал искать по проекту на Python Симптом простой: вызываешь чат, пишешь вопрос по коду, а редактор отвечает, что не знает структуру проекта, или выдает бесконечный статус индексации codebase. Для студии, где каждая минута разработчика стоит денег, это превращается в простой и раздражение. Официальная документация Cursor и баг-трекеры на форумах подтверждают: проблема чаще всего кроется в игнорировании файлов (.gitignore), проблемах с правами доступа или огромном объеме виртуального окружения (.venv), которое редактор пытается просканировать вместо исходного кода. Воспроизведение проблемы и причины сбоя индексации Чтобы понять, почему ломается поиск, нужно воспроизвести типичную ситуацию. Вы клонируете репозиторий с Python-проектом, открываете папку в Cursor, и внутри автоматически создается папка .venv с тысячами

Cursor AI не видит локальный проект на Python: как починить индексациюПоказать полностью
0
1
Никита Орлов
Никита ОрловУровень Курсант

Зачем перебирать библиотеки для логирования python Привет! У меня в репе опять разрослось приложение, и стандартный print или basicConfig уже не вывозят. Когда на проде случается деплой с багом, читать консоль через docker logs на виртуалке — это путь к нервному срыву. Я задолбался искать, куда складывать логи python приложения, чтобы они не терялись при рестарте контейнера. Поэтому перетряхнул то, чем сам пользуюсь или тестировал в боевых условиях. Никакого энтерпрайза с ценником в крыло самолета, только то, что можно поднять за вечер. 1. Loguru: кому да, кому нет Начну с базы. Loguru — это любовь с первой строчки в мануале. Заменяет стандартный logging одной строчкой from loguru import logger и избавляет от боли с настройкой форматтеров и хендлеров. У меня она стоит на всех пет-проектах и в паре микросервисов. Красивый вывод в консоль из

Инструменты для мониторинга логов python топ 5: мой личный выборПоказать полностью
0
1