dns-orchestrator-mcp

Model Context Protocol (MCP) server for DNS Orchestrator, exposing DNS management and network diagnostic tools to AI agents.

Shares account data with the DNS Orchestrator desktop app via SQLite database and system keyring. The MCP server itself performs read-only operations on existing data; however, if the database file does not exist, it will be created and initialized with the schema on first start.

Install

From crates.io

cargo install dns-orchestrator-mcp

From source

git clone https://github.com/AptS-1547/dns-orchestrator.git
cd dns-orchestrator
cargo build --release -p dns-orchestrator-mcp
# Binary: target/release/dns-orchestrator-mcp

Configure MCP Client

Add to your MCP client configuration:

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dns-orchestrator": {
      "command": "dns-orchestrator-mcp"
    }
  }
}

Claude Code

claude mcp add dns-orchestrator dns-orchestrator-mcp

Cursor / Windsurf

Add to .cursor/mcp.json or MCP settings:

{
  "mcpServers": {
    "dns-orchestrator": {
      "command": "dns-orchestrator-mcp"
    }
  }
}

If dns-orchestrator-mcp is not in your PATH, use the full path to the binary (e.g. ~/.cargo/bin/dns-orchestrator-mcp).

Available Tools

Account & DNS Management

Requires the DNS Orchestrator desktop app to be installed with accounts configured.

Network Diagnostics

Work standalone without any account configuration.

Data Sharing with Desktop App

The MCP server shares data with the DNS Orchestrator desktop app:

• SQLite database (data.db) — account configurations and domain metadata
• System keyring — provider credentials (API keys/tokens)

The server auto-detects the database from the desktop app's data directory:

If the database doesn't exist, the server creates and initializes it with the schema automatically. Network diagnostic tools work without any database.

Logging

Logs are written to stderr (MCP protocol uses stdout).

RUST_LOG=debug dns-orchestrator-mcp

License

MIT