MCP-сервер локально: как запустить и проверить в 2026

Локальный MCP-сервер можно проверить до подключения к ИИ-помощнику: запустить его через MCP Inspector, увидеть список инструментов и выполнить один безопасный вызов. Вам понадобятся компьютер, проверенная команда запуска уже установленного сервера и Node.js версии 22.19.0 или новее с npx (требование Inspector). Этот порядок рассчитан на сервер, который работает через stdio; для удалённого HTTP-сервера нужен другой способ подключения. Официальный пример MCP SDK показывает запуск через Inspector и различие транспортов.

Что значит «локальный» и что проверить заранее

В режиме stdio клиент сам запускает сервер как дочерний процесс и обменивается с ним сообщениями через стандартные потоки. Поэтому двойной щелчок по файлу или открытие адреса localhost не доказывает, что MCP работает. Сервер может молча ждать сообщения от клиента, и это нормальное состояние. Официальное руководство по первому серверу прямо описывает такое ожидание.

Перед проверкой выясните три вещи: откуда взят сервер, какой командой он запускается и какие действия предоставляют его инструменты. Если команда требует токен, храните его в предназначенном для этого окружении, не вставляйте значение в общедоступный чат и не выводите в журнал. Если сервер запускает команды, пишет файлы или обращается к почте, тестируйте его на отдельной папке и с ограниченными правами. Проверка подключения не даёт автоматически разрешение на действия с рабочими данными.

• Источник пакета или кода известен и вызывает доверие.
• Команда запуска воспроизводима в терминале без догадок о рабочей папке.
• Понятно, какой инструмент можно вызвать без записи и внешней отправки.
• Для теста подготовлены обезличенные данные и отдельная рабочая папка.

Если этих условий нет, сначала разберитесь с происхождением сервера. Общее объяснение MCP-сервера поможет отличить сам сервер от ИИ-клиента. Для разработки собственного сервера нужна другая последовательность, показанная в руководстве по серверу на Python.

Как запустить проверку через Inspector

MCP Inspector запускает команду локального stdio-сервера и подключается к ней как клиент. В официальном примере TypeScript SDK используется форма npx @modelcontextprotocol/inspector <команда сервера>. Заменяйте только часть после имени Inspector на реальную команду из документации выбранного сервера. Пример npx @modelcontextprotocol/inspector npx tsx src/index.ts относится к учебному серверу из этого руководства, а не к любому установленному пакету.

1. Откройте терминал в нужной рабочей папке и проверьте, что команда запуска сервера известна и доступна.
2. Запустите Inspector, передав ему эту команду. При первом запуске npx может запросить установку пакета: проверьте имя перед согласием.
3. Откройте локальный адрес, который Inspector вывел в терминал, и нажмите Connect.
4. Перейдите к Tools. Сверьте имена и описания инструментов с документацией сервера.
5. Вызовите только заранее выбранный инструмент без записи и сохраните результат проверки без секретов.

Критерий успеха здесь двойной: Inspector показывает соединение и список ожидаемых инструментов, а безопасный вызов возвращает осмысленный ответ. Одного зелёного индикатора мало: сервер может объявлять инструменты, но ошибаться при вызове. В официальном учебном примере после Connect открывают Tools и вызывают get-alerts с тестовым кодом штата; в вашей проверке должны быть свои документированные входные данные.

Правило безопасного теста: сначала прочитайте описание инструмента и его аргументов, затем вызовите действие, которое ничего не меняет. Инструмент с названием «проверить» тоже может обращаться к внешней системе.

Как отличить ошибку запуска от ошибки инструмента

Используйте короткую диагностическую последовательность. Inspector не открылся: проверьте наличие Node.js и npx, затем точность имени пакета. Интерфейс открылся, но сервер не подключился: выполните исходную команду сервера отдельно и посмотрите сообщения об ошибке, рабочую папку и требуемые переменные окружения. Подключение есть, но список пуст: убедитесь, что сервер действительно объявляет инструменты, а не только ресурсы или промпты. Список есть, но вызов падает: проверьте схему аргументов, разрешения и зависимые сервисы.

Для stdio важна чистота стандартного вывода: он занят сообщениями протокола. Обычные логи сервера надо писать в stderr, иначе случайный текст может сломать обмен. Это прямо указано в официальном руководстве SDK. Если сервер работает только через HTTP, не пытайтесь запускать его как stdio-процесс: различие транспортов требует выбрать URL и соответствующий режим клиента.

Это второй практический элемент: решение по первому наблюдаемому сбою. Сначала отделите неполадку самого Inspector, затем запуск сервера, затем регистрацию инструментов и только после этого конкретный вызов. Так вы не меняете конфигурацию ИИ-клиента вслепую.

По теме: Настройка ИИ-агента: цель, инструменты, права и проверка

Как перенести проверенный сервер в ИИ-клиент

После успешной проверки перенесите в настройку клиента ту же команду запуска, аргументы и необходимые переменные окружения. Используйте абсолютные пути, если сервер зависит от файла в проекте: клиент может запускаться из другой папки. Затем перезапустите или переподключите клиент и проверьте видимость инструмента на такой же безопасной операции. Официальный пример подключения MCP-сервера к хосту отдельно объясняет, почему для файлов нужен абсолютный путь.

Если вашим клиентом служит Codex, используйте отдельную инструкцию по подключению MCP к Codex. Успех в Inspector подтверждает протокол и сам инструмент, но не подтверждает, что конфигурация конкретного клиента написана верно или что этому клиенту разрешено действие. Не добавляйте широкие права только ради зелёного статуса.

Когда локальный запуск не подходит

Локальный stdio-сервер удобен для одного рабочего места и тестов. Для общего сервиса, к которому подключается несколько клиентов, официальная документация предлагает HTTP-транспорт. Для данных, к которым у вас нет права доступа, локальный запуск не меняет правовой или организационный запрет. Если нужен только результат от готового инструмента, установка собственного MCP-сервера может оказаться лишним шагом.

Частые вопросы

Сервер ничего не печатает после запуска. Он завис?

Не обязательно. Stdio-сервер часто ждёт клиента. Проверьте его через Inspector, как показано в примере SDK.

Можно ли проверить локальный сервер без Codex или Claude?

Да. Inspector выступает отдельным клиентом: показывает инструменты и позволяет вызвать их вручную. Это помогает отделить ошибку сервера от настройки конкретного ИИ-помощника.

Почему инструмент виден, но не отвечает?

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

Нужно ли открывать локальный порт в интернет?

Для stdio нет: клиент запускает процесс локально и общается через потоки. Не публикуйте тестовый интерфейс или сервер наружу без отдельной задачи и настройки доступа.