Manage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics.
npx @getmcp/cli add io.github.hydradns/hydra-mcpRequires Docker Engine. Community-contributed server. Review source before installing.
HYDRA_API_URLBase URL of the HydraDNS controlplane API. Inside a container, 'localhost' means the container itself, not the host running the controlplane. On Docker Desktop (Mac/Windows) the default below resolves automatically. On plain Docker Engine (Linux) either run the container with --add-host=host.docker.internal:host-gateway, or use --network host with http://localhost:8080 instead. Full instructions: docs/mcp.md in the repo, 'Running it -> As the container image'.
HYDRA_TOKENBearer token for the HydraDNS API, obtained via `hydra login` or the setup wizard. Grants whatever access the token's account has; MCP_ROLE narrows what the MCP tool layer will call, not what the token itself can do against the API directly.
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"io.github.hydradns/hydra-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"env": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "",
"MCP_ROLE": "admin"
}
}
}
}