SpecForge — MCP-сервер для Claude Code: что делает и как установить
Превращает требования команды в строгие детерминированные проверки спецификаций для ИИ-агентов, исключая пропуск правил архитектуры и логики.
Открыть на GitHubЧто делает SpecForge
ИИ-агенты часто пропускают требования, спрятанные в длинных файлах Markdown или PRD. SpecForge переносит инженерные договорённости в типизированные файлы .spec. Агент формирует черновик с инвариантами, поведением и событиями, а SpecForge проверяет его как компилятор.
Внутри нет нейросетей, поэтому валидатор всегда возвращает одинаковый результат на один и тот же файл. Инструмент отслеживает опечатки в идентификаторах, забытые события, нехватку обязательных полей вроде guarantee и оторванные от логики инварианты. Команда specforge check выдаёт точный номер строки и подсказку для исправления. Ошибки блокируют агента сразу.
Для подтверждения требований используется утилита specforge collect. Она связывает юнит-тесты с описанными в спецификации контрактами и фиксирует доказанные правила.
Какие задачи решает
- проверить целостность инвариантов и событий в файлах
.spec - найти опечатки и оборванные ссылки в требованиях до генерации кода
- связать юнит-тесты с описанными контрактами через
specforge collect - заблокировать агенту сдачу кода с непроверенными условиями
Примеры запросов агенту
- Опиши сценарий возврата платежа в
spec/refund.specи выполниspecforge check - Исправь ошибку E003 в
spec/hello.specпо подсказке компилятора - Проверь покрытие контрактов тестами через команду
specforge collect
Как установить SpecForge
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SpecForge
Как установить SpecForge в Claude Code?
Выполните установочный скрипт curl -fsSL https://raw.githubusercontent.com/leaderiop/SpecForge/main/install.sh | sh, затем инициализируйте проект командой specforge init --extensions @specforge/software.
Что делает SpecForge?
Инструмент проверяет .spec файлы как компилятор, контролируя связи между сущностями, событиями и инвариантами. Он работает детерминированно и возвращает агенту чёткие ошибки компиляции при нарушении правил.
Чем SpecForge отличается от описания правил в Markdown?
Инструкции в свободной прозе агент может проигнорировать при смене контекста. SpecForge валидирует спецификацию программно: если правило не подкреплено кодом или содержит опечатку, проверка завершается с ошибкой.
