mcpField
H
HydraDNS

HydraDNS

Local
github.comSecurity1Updated 5w ago
RepositoryVisit website

About HydraDNS

Manage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hydradns-hydra": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HYDRA_API_URL",
        "-e",
        "HYDRA_TOKEN",
        "-e",
        "MCP_ROLE",
        "ghcr.io/hydradns/hydra-cli:0.1.0"
      ],
      "env": {
        "HYDRA_API_URL": "<HYDRA_API_URL>",
        "HYDRA_TOKEN": "<HYDRA_TOKEN>",
        "MCP_ROLE": "<MCP_ROLE>"
      }
    }
  }
}
Run commanddocker run -i --rm -e HYDRA_API_URL -e HYDRA_TOKEN -e MCP_ROLE ghcr.io/hydradns/hydra-cli:0.1.0
Environment variables to set
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_TOKENSecretBearer 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.
MCP_ROLEPermission scope for this MCP session: admin (default, every tool), operator (every mutating tool except toggle_engine), or reporter (read-only tools only). Any unrecognized value safe-defaults to reporter.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/hydradns/hydra-cli:0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.