mDNS Discovery

PyPI Python Ruff

MCP server that exposes mDNS (Multicast DNS) service discovery functionality via the Model Context Protocol. Enables LLMs to discover and query zero-configuration network services on the local network.

mcp-name: io.github.daedalus/mcp-mdns

Install

pip install mcp-mdns

Usage

# Run the MCP server
mcp-mdns

Or run directly with Python:

python -m mcp_mdns

MCP Server Configuration

Configure your MCP client with:

{
  "mcpServers": {
    "mdns": {
      "command": "mcp-mdns",
      "env": {}
    }
  }
}

Available Tools

• mdns_list_service_types — List all service types advertised on the local network
• mdns_browse_services — Browse for services of a specific type (e.g., _http._tcp, _printer._tcp)
• mdns_get_service_info — Get detailed information about a specific service (host, port, TXT records)
• mdns_resolve_hostname — Resolve a .local hostname to IP addresses
• mdns_register_service — Register a new service on the local network
• mdns_unregister_service — Unregister a previously registered service

Development

git clone https://github.com/daedalus/mcp-mdns.git
cd mcp-mdns
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

License

MIT