Перейти к содержимому
F●RGEPLAN

forgeplan mcp serve

forgeplan mcp serve - это тонкий алиас для forgeplan serve. Обе команды запускают один и тот же MCP-сервер (stdio transport, 73 инструмента, одно рабочее пространство) и завершаются по Ctrl-C. Алиас существует, чтобы namespace mcp был внутренне консистентным - после forgeplan mcp install очевидное продолжение для отладки - это forgeplan mcp serve.

Полный справочник (доступные инструменты, детали транспорта, troubleshooting, примеры конфигурации клиентов) - см. forgeplan serve.

Когда использовать

Заголовок раздела «Когда использовать»
  • Ручная отладка: подавать JSON-RPC запросы, изучать ответы.
  • Валидация соответствия MCP-протоколу через mcp-inspector.
  • Smoke-тестирование после релиза, что бинарник стартует и отдаёт схему инструментов.

Когда НЕ использовать

Заголовок раздела «Когда НЕ использовать»
  • Для повседневной работы с агентом - MCP-клиент (Claude Code, Cursor, Windsurf) запускает сервер за вас. Ручной вызов - редкость.
  • Для конфигурации сервера - на командной строке настраивать нечего. Сервер читает ./.forgeplan/.

Использование

Заголовок раздела «Использование»
forgeplan mcp serve

Эквивалентно:

forgeplan serve

Опции

Заголовок раздела «Опции»
  -h, --help     Print help
  -V, --version  Print version

Никаких runtime-опций - сервер берёт рабочее пространство из ./.forgeplan/, а LLM-провайдера - из .forgeplan/config.yaml.

Примеры

Заголовок раздела «Примеры»

Smoke-тест после установки

Заголовок раздела «Smoke-тест после установки»
Окно терминала
cd /path/to/project
forgeplan mcp serve
# Server waits on stdin for JSON-RPC. Ctrl-C to exit.

Если процесс не падает сразу же - бинарник стартует. Используйте mcp-inspector для интерактивного дампа списка инструментов.

Отладка кастомного MCP-инструмента

Заголовок раздела «Отладка кастомного MCP-инструмента»
Окно терминала
RUST_LOG=debug forgeplan mcp serve

RUST_LOG=debug поднимает rmcp-trace диспатча - полезно, когда новый инструмент зарегистрирован, но клиент утверждает, что его не существует.

Место в рабочем процессе

Заголовок раздела «Место в рабочем процессе»

mcp serve - это runtime entry point: AI-агенты (Claude Code, Cursor, Windsurf) запускают его как подпроцесс через файл конфигурации, который записал forgeplan mcp install. Вы почти никогда не вызываете его напрямую при обычной работе с артефактами - цикл методологии (Shape → Validate → Code → Evidence → Activate) выполняется через инструменты, которые предоставляет сервер, а не через эту команду.

См. также

Заголовок раздела «См. также»