forgeplan serve

Запускает сервер Forgeplan MCP (Model Context Protocol) через stdio. Это основная точка интеграции для ИИ-агентов - Claude Code, Cursor, Windsurf и другие MCP-клиенты запускают forgeplan serve как дочерний процесс и общаются с ним по JSON-RPC через stdin/stdout.

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

forgeplan serve

Опции

  -h, --help     Вывести справку
  -V, --version  Вывести версию

Что он предоставляет

63 MCP-инструмента, сопоставленных с основными операциями Forgeplan:

Жизненный цикл артефактов - new, validate, review, activate, supersede, deprecate, stale, renew, reopen
Запросы + обнаружение - list, get, search, blocked, order, tree, discover, blindspots, gaps
Оценка + рассуждение - score, fgr, reason, route, estimate
Доказательства + связи - link, unlink, new_evidence
Теги - tag, untag
Здоровье + наблюдаемость - health, status, coverage, drift
База знаний FPF - fpf_search, fpf_section, fpf_check
Память - remember, recall, promote

Forgeplan является MCP-ориентированным: CLI - это удобная обёртка, а вся мощь инструмента предназначена для управления ИИ-агентами через этот сервер.

Транспорт

Только stdio - без HTTP, без сокетов, без сетевого доступа. MCP-клиент владеет процессом и общается через каналы.
Одно рабочее пространство на сервер - сервер запускается в текущей рабочей директории и работает с ./.forgeplan/. Запускайте его из корневой директории проекта.
Без сохранения состояния - нет долгосрочного состояния между запросами, кроме того, что хранится в LanceDB и markdown.

Примеры

Пример 1: Конфигурация клиента Claude Code

См. раздел “Типичное использование” ниже.

Пример 2: Ручное дымовое тестирование

См. раздел “Ручное использование (отладка)” ниже.

Типичное использование (автоматическое)

Обычно вы не запускаете serve вручную. MCP-клиенты запускают его как дочерний процесс через свой файл конфигурации. Для Claude Code добавьте в ~/.claude/mcp.json:

{
  "mcpServers": {
    "forgeplan": {
      "command": "forgeplan",
      "args": ["serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

Cursor (~/.cursor/mcp.json) и Windsurf используют ту же схему. Перезапустите клиент; инструменты Forgeplan (mcp__forgeplan__*) станут доступны агенту.

Ручное использование (отладка)

Запускайте serve напрямую только в следующих случаях:

Отладка нового MCP-инструмента - подключите его вручную, передайте JSON-RPC запросы через пайп, проверьте ответ.
Валидация соответствия протоколу - запустите с mcp-inspector или аналогичным инструментом.
Дымовое тестирование после релиза - убедитесь, что бинарный файл запускается и выводит схему своих инструментов.

# Ручное дымовое тестирование
cd /path/to/project
forgeplan serve
# (сервер ожидает JSON-RPC сообщений на stdin)
# Ctrl-C для выхода

Для интерактивного исследования инструмент mcp-inspector гораздо продуктивнее, чем ручное написание JSON-RPC.

Устранение неполадок

“Рабочее пространство не найдено” - сервер был запущен в директории без .forgeplan/. Установите cwd в конфигурации вашего MCP-клиента на корневую директорию проекта.
Инструменты отсутствуют в клиенте - перезапустите MCP-клиент после редактирования его конфигурации; большинство клиентов считывают mcp.json только при запуске.
Функции LLM не работают - инструменты, поддерживаемые LLM (reason, route), требуют настройки провайдера в .forgeplan/config.yaml. См. руководство по LLM.
Семантические инструменты неактивны - флаг функции embed должен быть скомпилирован для семантического поиска; в противном случае эти инструменты возвращаются к поиску по ключевым словам.

См. также

Обзор CLI
Справочник по MCP-инструментам - полный список предоставляемых инструментов
forgeplan health - проверка рабочего пространства перед запуском сервера
forgeplan reindex - перестроение индекса, если инструменты возвращают устаревшие данные