sdd-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает методологию Spec-Driven Development к ассистенту. Блокирует написание кода до утверждения спецификаций и плана задачи.
claude mcp add --env SDD_PROJECT_ROOT=<SDD_PROJECT_ROOT> --env SDD_WORKSPACES_ROOT=<SDD_WORKSPACES_ROOT> --transport stdio sdd-mcp -- npx -y @juanklagos/sdd-mcpЧто делает sdd-mcp
Сервер связывает ИИ-агента с каталогом specs/ и журналом решений bitacora/. Спецификация идёт первой. Главное правило процесса строгое: никакого рабочего кода в репозитории, пока человек явно не подтвердит файл требований spec.md и согласованный с ним plan.md.
Инструмент проверяет соблюдение контрольных точек перед реализацией фичи. Для выполнения проверок и фиксации согласия используются скрипты валидации проекта. Сервер развёртывается через npx с пакетом @juanklagos/sdd-mcp.
Без прописанных путей SDD_PROJECT_ROOT и SDD_WORKSPACES_ROOT сервер потеряет контекст рабочего каталога.
Какие задачи решает
- зафиксировать требования к задаче в файле спецификации до начала кодинга
- проверить согласованность архитектурного плана и исходных требований
- записать инженерные решения в журнал
bitacora/ - заблокировать несанкционированное написание кода агентом
Примеры запросов агенту
- Сверь спецификацию в
specs/с планом и проверь прохождение гейта перед написанием кода. - Зафиксируй решение по архитектуре базы данных в
bitacora/decisiones/.
Как установить sdd-mcp
Командой платформы
claude mcp add --env SDD_PROJECT_ROOT=<SDD_PROJECT_ROOT> --env SDD_WORKSPACES_ROOT=<SDD_WORKSPACES_ROOT> --transport stdio sdd-mcp -- npx -y @juanklagos/sdd-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add sdd-mcp --env SDD_PROJECT_ROOT=<SDD_PROJECT_ROOT> --env SDD_WORKSPACES_ROOT=<SDD_WORKSPACES_ROOT> -- npx -y @juanklagos/sdd-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"sdd-mcp": {
"command": "npx",
"args": [
"-y",
"@juanklagos/sdd-mcp"
],
"env": {
"SDD_PROJECT_ROOT": "<SDD_PROJECT_ROOT>",
"SDD_WORKSPACES_ROOT": "<SDD_WORKSPACES_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"sdd-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@juanklagos/sdd-mcp"
],
"env": {
"SDD_PROJECT_ROOT": "<SDD_PROJECT_ROOT>",
"SDD_WORKSPACES_ROOT": "<SDD_WORKSPACES_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SDD_PROJECT_ROOT=<SDD_PROJECT_ROOT> -e SDD_WORKSPACES_ROOT=<SDD_WORKSPACES_ROOT> sdd-mcp npx -y @juanklagos/sdd-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sdd-mcp
Как установить sdd-mcp в Claude Code?
Выполните команду claude mcp add sdd-mcp -- npx -y @juanklagos/sdd-mcp. Если нужны переменные окружения, передайте их: `claude mcp add --env SDD_PROJECT_ROOT=<SDD_PROJECT_ROOT> --env SDD_WORKSPACES_ROOT=<SDD_WORKSPACES_ROOT> --transport stdio sdd-mcp -- npx -y @juanklagos/sdd-mcp`.
Что делает sdd-mcp?
Сервер внедряет процесс разработки от спецификаций, запрещая модели менять кодовую базу без одобренного файла spec.md и согласованного плана.
Какие переменные окружения нужны для работы сервера?
Для привязки к рабочим папкам сервер принимает переменные SDD_PROJECT_ROOT и SDD_WORKSPACES_ROOT.
