cfgd — MCP-сервер для Claude Code: что делает и как установить
Декларативно управляет окружением рабочей машины, пакетами и конфигурацией через GitOps-подход. Помогает поддерживать единое состояние системы на разных компьютерах.
claude mcp add cfgd -- docker run -i --rm ghcr.io/tj-smith47/cfgd:0.12.0Что делает cfgd
Инструмент описывает окружение компьютера в формате YAML: системные пакеты, конфигурационные файлы, переменные окружения и секреты. На основе профилей с поддержкой наследования сервер сверяет фактическое состояние системы с желаемым, строит план изменений и устраняет расхождения.
Конфигурация разбивается на модули, которые сами подбирают нужный менеджер пакетов под операционную систему. Если в модуле задействована автоматическая генерация правил, потребуется ключ ANTHROPIC_API_KEY. Запуск сервера выполняется в контейнере Docker.
Проект находится в стадии Alpha, поэтому схемы данных и команды могут меняться. Ошибки выполнения отдельных шагов протоколируются без аварийной остановки всего процесса.
Какие задачи решает
- Синхронизировать файлы конфигурации между рабочими компьютерами
- Настроить окружение в новом контейнере одной командой
- Отслеживать и устранять расхождения в установленных системных пакетах
- Разделять базовые настройки и параметры отдельных машин через профили
Примеры запросов агенту
- Проверь текущее состояние машины через
cfgd statusи покажи расхождения с профилем - Составь YAML-модуль
nvimдля установки редактора и зависимостей - Примени изменения конфигурации рабочей машины с помощью
cfgd apply
Как установить cfgd
Командой платформы
claude mcp add cfgd -- docker run -i --rm ghcr.io/tj-smith47/cfgd:0.12.0Командой платформы
codex mcp add cfgd -- docker run -i --rm ghcr.io/tj-smith47/cfgd:0.12.0Файл настроек
{
"mcpServers": {
"cfgd": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tj-smith47/cfgd:0.12.0"
]
}
}
}Файл настроек
{
"servers": {
"cfgd": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tj-smith47/cfgd:0.12.0"
]
}
}
}Командой платформы
gemini mcp add cfgd docker run -i --rm ghcr.io/tj-smith47/cfgd:0.12.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о cfgd
Как установить cfgd в Claude Code?
Выполните команду claude mcp add cfgd -- docker run -i --rm ghcr.io/tj-smith47/cfgd:0.12.0. Для запуска потребуется предварительно установленный Docker.
Что делает MCP-сервер cfgd?
Он даёт доступ к декларативному управлению системными пакетами, файлами конфигурации и профилями окружения по принципам GitOps.
Что нужно для автоматической генерации конфигурации?
Для работы команды cfgd generate необходимо задать переменную окружения ANTHROPIC_API_KEY с вашим ключом.
