Перейти к содержанию
modelium.
Начать с задачи
←
Новость

MCP Inspector v2: перенести проверку инструментов из v1

На странице · 2 разделов

Если прежняя CLI-проверка MCP-сервера перестала работать после обновления Inspector, проверьте версию Node, расположение флага --cli и новый код завершения. В v2 --config читает существующий файл без правки, а --catalog позволяет редактировать список серверов. Сначала проверьте команды на учебном сервере с безвредным echo; успешный ответ не проверяет права вашего рабочего сервера.

После обновления MCP Inspector прежняя проверка сервера не показывает инструмент или стала завершаться ошибкой? MCP — способ дать программе список действий, например поиск по файлам. Inspector проверяет этот обмен без языковой модели; его CLI — вариант для запуска командой из терминала. Ниже вы сначала получите ответ от учебного сервера, а затем сможете проверить настройки своего. Это инженерная инструкция, не рецепт установки модели дома. s1 s2

Проверено 24 октября 2026 года: Inspector 2.12.0 и официальный тестовый Everything 2.0.0 на Linux с Node 24.21.0; редакция получила Echo: smoke24 и код выхода 0. Свой рабочий сервер, его токены, права пользователей и модель редакция не проверяла. Для Inspector v2 нужен Node 22.19.0+, а для выбранного учебного сервера — Node 24+; RAM/VRAM конкретной модели здесь не рассматриваются. s1 s4

Как проверить v2 на безвредном сервере?

  1. Откройте терминал в Linux или macOS и выполните node -v. Node.js запускает эти программы, а npx загружает и запускает пакеты из каталога npm. Если версия ниже 24, сначала установите поддерживаемую Node.js 24; это требование учебного Everything, а не общая граница Inspector. Для первой загрузки пакетов нужен интернет. Не запускайте для опыта неизвестный MCP-сервер с доступом к рабочим документам. s1 s4
  2. Выполните MCP_INSPECTOR_SECRET_STORE=memory npx --yes @modelcontextprotocol/inspector@2.12.0 --cli npx --yes @modelcontextprotocol/server-everything@2.0.0 --method tools/list --format json --connect-timeout 15000. Ищите echo в result.tools: это список, а не доказательство вызова. memory не сохраняет секреты Inspector на диск; в этом учебном примере токены не нужны. У v2 --format json выдаёт объект с result; сообщения запуска сервера могут появиться отдельно в stderr — служебном потоке ошибок, который не входит в JSON. s2 s3 s4
  3. Вызовите только безопасный учебный инструмент: MCP_INSPECTOR_SECRET_STORE=memory npx --yes @modelcontextprotocol/inspector@2.12.0 --cli npx --yes @modelcontextprotocol/server-everything@2.0.0 --method tools/call --tool-name echo --tool-args-json '{"message":"smoke24"}' --format json --connect-timeout 15000. В result.content ожидайте Echo: smoke24 и код завершения 0. Редакция получила именно такой ответ на своей Linux-фикстуре; это не обещание результата на любой ОС или чужом сервере. Не подставляйте в этот тест пароли или личные данные. s2 s4

Что заменить в прежней CLI-проверке?

Если у вас уже есть собственный файл MCP-серверов, оставьте его на месте: в v2 --config — чтение существующего файла без записи, а --catalog — список, который Inspector может менять. В проверочной команде убедитесь, что --cli стоит сразу после имени пакета; для конкретного сервера задайте --server и начните с --method initialize, который подключается, но не вызывает инструмент. Затем при необходимости выполните tools/list. Не применяйте вызов неизвестного рабочего инструмента только потому, что учебный echo удался. s1 s2 s5

Для автоматической проверки (CI) закрепите точную версию, как выше: неприкреплённый npx @modelcontextprotocol/inspector может получить иную версию. Используйте --format json, читайте result и сохраняйте код завершения. Раньше инструмент мог сообщить об ошибке, но сама программа проверки завершалась успешно (код 0); в v2 ответ с isError: true даёт код 5. Поэтому старый сценарий может впервые показать сбой — прочитайте ответ инструмента, прежде чем считать переход на v2 причиной. s1 s2

На сервере без доступной системной ключницы Inspector по умолчанию может хранить токены в локальном ~/.mcp-inspector/secrets.json. Для опыта выше выбран MCP_INSPECTOR_SECRET_STORE=memory; он не заменяет управление секретами вашего рабочего подключения. Полная проверка прав и отказа опасному вызову — отдельный тест на изолированном стенде, а не результат учебного echo. s3 s4

Если нужен первый собственный безопасный инструмент, откройте гайд по локальному MCP-серверу; для рабочего доступа дополнительно изучите проверку разрешений. s2

Источники

  1. MCP Inspector 2.12.0 — переход с v1 на v2 — revision 0cac110a809e93753fa353810b9b4c91e89810fc; Node, единый пакет, режим CLI, конфигурация и новая семантика exit. Снимок сохранён локально.. Получено 24.10.2026.
  2. MCP Inspector — CLI smoke-testing — revision 0cac110a809e93753fa353810b9b4c91e89810fc; Пин версии, --format json, --tool-args-json, exit 5; учебные результаты не заменяют тест безопасности.. Получено 24.10.2026.
  3. MCP Inspector — хранение секретов — revision 0cac110a809e93753fa353810b9b4c91e89810fc; По умолчанию ключница ОС при доступности, иначе файл; memory — явный бездисковый режим.. Получено 24.10.2026.
  4. Everything MCP Server 2.0.0 — учебный сервер — revision 51b6382a3e827aceb6bce430b1208d69b93d95ea; Node >=24; тестовый, не production-сервер; stdio через npx.. Получено 24.10.2026.
  5. MCP Inspector — CLI reference — revision 0cac110a809e93753fa353810b9b4c91e89810fc; Флаги CLI, выбор target/config, JSON-результат и exit codes.. Получено 24.10.2026.