Caddy MCP Server — MCP-сервер для Claude Code
Управляет веб-сервером Caddy через admin API: конфигурация, маршруты, TLS, метрики и снапшоты прямо из чата с агентом.
claude mcp add caddy-mcp -- npx -y @yawlabs/caddy-mcpЧто делает Caddy MCP Server
Сервер даёт доступ к admin API Caddy — 18 инструментов и 4 ресурса для конфигурации, маршрутов, обратных прокси, TLS, PKI, метрик и снапшотов. Запись через ETag (If-Match) исключает перезапись чужих изменений. Инструмент caddy_config_set по умолчанию перезаписывает (overwrite), а не добавляет (append) — повторный вызов не создаёт дубли маршрутов. Парсинг конфига защищён от падений даже на некорректной структуре.
Caddy запускает admin API на localhost:2019 по умолчанию. Для Docker или удалённого хоста задайте CADDY_ADMIN_URL. Без активного Caddy на этом порту или адреса в переменной окружения инструменты вернут ошибку подключения. Опциональный токен CADDY_API_TOKEN отправляется как Authorization: Bearer — нужен только если перед admin API стоит аутентифицирующий прокси.
Какие задачи решает
- настроить обратный прокси из чата с агентом
- получить список маршрутов и настройки TLS
- загрузить полный снапшот конфигурации
- проверить метрики Prometheus веб-сервера
- управлять сертификатами PKI
Примеры запросов агенту
- Настрой обратный прокси с
api.localнаlocalhost:3000 - Какие маршруты настроены на
srv0? - Покажи метрики Prometheus
Как установить Caddy MCP Server
Командой платформы
claude mcp add caddy-mcp -- npx -y @yawlabs/caddy-mcpКомандой платформы
codex mcp add caddy-mcp-server -- npx -y @yawlabs/caddy-mcpФайл настроек
{
"mcpServers": {
"caddy-mcp-server": {
"command": "npx",
"args": [
"-y",
"@yawlabs/caddy-mcp"
]
}
}
}Файл настроек
{
"servers": {
"caddy-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@yawlabs/caddy-mcp"
]
}
}
}Командой платформы
gemini mcp add caddy-mcp-server npx -y @yawlabs/caddy-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Caddy MCP Server
Как установить Caddy MCP Server в Claude Code?
Выполните команду claude mcp add caddy-mcp -- npx -y @yawlabs/caddy-mcp, затем перезапустите Claude Code и подтвердите подключение сервера.
Что делает Caddy MCP Server?
Сервер предоставляет инструменты для управления веб-сервером Caddy через admin API: изменение конфигурации, маршрутов, настроек TLS, PKI, чтение метрик и работа со снапшотами. Всё это доступно из чата с ИИ-агентом.
Для чего нужна переменная CADDY_ADMIN_URL?
Она задаёт адрес admin API Caddy. По умолчанию это http://localhost:2019. Если Caddy запущен в Docker или на удалённом хосте, укажите соответствующий адрес — например, http://caddy:2019 внутри Docker-сети.
