Никита Орлов
Никита ОрловТариф БортинженерКод и разработка
@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
13

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

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

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

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

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

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

Никита Орлов
Никита ОрловТариф Бортинженер

Как не упереться в лимит запросов в Claude Code и что делать Короче, если вы уже крутите Claude Code в терминале, то наверняка видели эту злую ошибку про rate limit. Сидишь такой, дебажишь сложный баг, агент бодро пишет код, рефакторит тесты — и тут бац: «Rate limit reached». Всё, приплыли, кукушка говорит «ждите час» или сколько там до сброса. У меня такое происходит регулярно, если дать агенту волю. Раньше я просто пускал его в проект и говорил: «Почини всё». Это главная ошибка. Claude начинает читать вообще всю репу, тащит в контекст гигабайты логов и node_modules, если они не заигнорены, и сжирает месячный лимит токенов за полчаса активной работы. Давайте разберем, как я теперь экономлю запросы и выживаю без нервных срывов. Почему улетает claude code rate limit и как с этим жить Основная проблема — контекст. Агенты устроены так, что с

Как не упереться в лимит запросов в Claude Code и что делатьПоказать полностью
0
17
Никита Орлов
Никита ОрловТариф Бортинженер

Зачем вообще запускать локальные модели для кода У меня в репе лежат приватные ключи, проприетарные алгоритмы и куча legacy, которую стыдно показывать даже коллегам, не то что облачным провайдерам. Вчера очередной агент попытался слить кусок контекста наружу, и я психанул. Решил, что хватит кормить чужие датасеты своими энтерпрайз-костылями. Поставил Ollama, выделил под это дело локальную тачку с нормальной видюхой и начал тестировать лучшие модели для кода локально. Главный критерий простой: чтобы она не тупила на автодополнении в Cursor или VS Code и выдавала рабочий синтаксис с первой попытки, а не генерировала синтаксический мусор. Ниже — мой личный топ-5 локальных нейросетей для программирования, которые я потрогал руками, покрутил в разных сценариях и отобрал для повседневной разработки. 1. DeepSeek-Coder-V2: тяжёлая артиллерия для

Какие локальные LLM для написания кода запустить: топ-5 моделейПоказать полностью
0
19
Никита Орлов
Никита ОрловТариф Бортинженер

Введение в мультиагентные системы: почему старые подходы больше не тащат Привет! У меня в репе за последние полгода скопилось столько экспериментов с AI-агентами, что пора бы разложить всё по полочкам. Если раньше мы просто кидали промпты в LLM через API и радовались, то теперь бизнес требует полноценных конвейеров. Один агент пишет код, второй ищет баги, третий ревьюит — и всё это должно крутиться без падений. Пытаться писать такую оркестрацию на голом Python и костылях из asyncio — верный способ поседеть к релизу. Нужны нормальные фреймворки для мультиагентных систем, топ которых я как раз и хочу разобрать. Ниже — пять инструментов, которые мы щупали руками, ловили на них баги и собирали работающие контуры. LangGraph: когда нужен полный контроль над состоянием графа Первый кандидат в нашем списке — LangGraph от команды LangChain. Я начинал с

Фреймворки для мультиагентных систем: топ-5 инструментов в 2025Показать полностью
0
27
Никита Орлов
Никита ОрловТариф Бортинженер

Claude Code — автономный агент от Anthropic для работы в терминале с доступом к файловой системе и git, в то время как GitHub Copilot CLI расширяет экосистему GitHub для выполнения команд через интерфейс командной строки. Инструменты подходят бэкенд-разработчикам и DevOps-инженерам для терминальной автоматизации; версия Claude Code распространяется по модели исследовательской превью-версии (research preview), а Copilot CLI требует активной подписки GitHub Copilot. Архитектура агентов Claude Code и GitHub Copilot CLI Архитектура Claude Code построена как автономный агент командной строки, который самостоятельно выполняет чтение файлов, поиск по кодовой базе, запуск тестов и формирование git-коммитов. Агент запрашивает у пользователя подтверждение перед потенциально опасными операциями записи. GitHub Copilot CLI функционирует преимущественно как

Показать полностью
0
5
Никита Орлов
Никита ОрловТариф Бортинженер

Для настройки MCP сервера в расширении Cline для VS Code требуется прописать блок mcpServers в конфигурационном файле cline_mcp_settings.json с указанием абсолютных путей к исполняемым файлам среды Node.js или Python. Инструкция актуальна для документации Cline и спецификации Model Context Protocol; главное ограничение интеграции заключается в жестких таймаутах STDIO-потоков при инициализации тяжелых npm-пакетов. Архитектура Model Context Protocol и место Cline в репозитории Model Context Protocol разработан для унификации взаимодействия языковых моделей с локальными инструментами и источниками данных. Расширение Cline выступает в роли MCP-клиента внутри среды разработки VS Code, отправляя JSON-RPC запросы к локально запущенным серверам через стандартные потоки ввода-вывода (STDIO) или HTTP SSE. Согласно официальной спецификации Model Context

Настройка Cline MCP server в VS Code: реальный тест и разбор ошибокПоказать полностью
0
9
Никита Орлов
Никита ОрловТариф Бортинженер

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

Показать полностью
0
25