confdiff-mcp — MCP-сервер для Claude Code: diff конфигов по смыслу
Сравнивает конфиги JSON, YAML, TOML, INI, .env и XML по данным, а не по тексту. Агент видит только настоящие изменения, а секреты остаются скрытыми.
claude mcp add confdiff-mcp -- npx -y confdiff-mcpЧто делает confdiff-mcp
Сервер разбирает каждый файл в модель данных и сравнивает модели. Перестановка ключей, смена кавычек, перенос массива на несколько строк, новый комментарий — всё это не считается изменением. В ответ приходит строка на каждую реальную правку: путь, старое значение, новое. Заодно ловятся смены типа, когда 80 превращается в "80".
Работает с восемью форматами, включая JSON с комментариями, многофайловый YAML с разделителями --- и CSV с автоопределением разделителя. Можно сравнивать config.json с мигрировавшим config.yaml или две директории целиком, сопоставляя файлы по относительному пути.
Секреты при --redact заменяются стабильным отпечатком вида «redacted:1a2b3c»: видно, что пароль поменялся, но само значение не попадает ни в контекст модели, ни в лог. Чего ждать не стоит — смыслового сравнения там, где формат не распознан; сервер запускается через npx -y confdiff-mcp, поэтому Node.js должен быть в системе.
Какие задачи решает
- убрать шум из diff конфигов перед ревью
- поймать смену типа значения, которую
git diffне показывает - проверить, что после миграции JSON в YAML данные не поехали
- сравнить два рендера Helm или два дерева конфигов по файлам
- показать агенту расхождение паролей, не отдавая сами пароли
Примеры запросов агенту
- Сравни
old.yamlиnew.yamlпо смыслу и покажи только реальные изменения - Прогони confdiff по
prod.envиstaging.envс--redactи скажи, какие секреты разошлись - Сравни директории
old-manifests/иnew-manifests/: какие файлы добавлены, удалены или изменены
Как установить confdiff-mcp
Командой платформы
claude mcp add confdiff-mcp -- npx -y confdiff-mcpКомандой платформы
codex mcp add confdiff-mcp -- npx -y confdiff-mcpФайл настроек
{
"mcpServers": {
"confdiff-mcp": {
"command": "npx",
"args": [
"-y",
"confdiff-mcp"
]
}
}
}Файл настроек
{
"servers": {
"confdiff-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"confdiff-mcp"
]
}
}
}Командой платформы
gemini mcp add confdiff-mcp npx -y confdiff-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о confdiff-mcp
Как установить confdiff-mcp в Claude Code?
Одной командой: claude mcp add confdiff-mcp -- npx -y confdiff-mcp.
Что делает confdiff-mcp?
Даёт агенту инструмент семантического diff конфигов: файлы парсятся в модель данных, и в отчёт попадают только реальные различия в ключах и значениях. Перестановки и переформатирование отбрасываются.
Безопасно ли отдавать конфиги агенту?
С флагом --redact значения секретов заменяются отпечатком, поэтому в контекст модели уходит только факт изменения. Сами пароли и токены остаются снаружи.
