mcp-caddy

MCP server for Caddy web server management. Exposes 7 tools for inspecting routes, upstream health, certificates, and reloading configuration via the Caddy admin API.

Quick Start

With uvx (recommended):

CADDY_HOST=http://10.0.0.31:2019 uvx mcp-caddy

With Docker:

docker run -i \
  -e CADDY_HOST=http://10.0.0.31:2019 \
  ghcr.io/aaronckj/mcp-caddy:latest

Add to Claude Code:

claude mcp add caddy -s user -e CADDY_HOST=http://10.0.0.31:2019 -- uvx mcp-caddy

Related MCP server: Identity Admin MCP Server

Configuration

Finding Your CADDY_HOST

The Caddy admin API binds to localhost:2019 by default. Depending on your setup:

1. MCP server on same host as Caddy → use the default http://localhost:2019

2. Caddy in Docker, MCP server on the same Docker host → add ports: ["127.0.0.1:2019:2019"] to your Caddy compose service, then use http://localhost:2019

3. Remote Caddy host → SSH tunnel: ssh -L 2019:localhost:2019 user@caddy-host, then use http://localhost:2019

4. Caddy exposes admin via reverse proxy → set CADDY_HOST=https://caddy-admin.example.com

The Caddy admin API has no authentication by default. If you expose it beyond localhost, add Caddy basic auth to that route.

Tools

Development

git clone https://github.com/aaronckj/mcp-caddy
cd mcp-caddy
uv sync --extra dev
uv run pytest -v