tailscale-mcp-server

MattSayar/tailscale-mcp-server

3.2

If you are the rightful owner of tailscale-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Tailscale MCP Server provides safe, read-only access to Tailscale diagnostic information using the Model Context Protocol.

Tools
8
Resources
0
Prompts
0

Tailscale MCP Server

An MCP (Model Context Protocol) server that provides safe, read-only access to Tailscale diagnostic information.

Features Implemented

Tools

  • network_check - Runs tailscale netcheck to diagnose network connectivity
  • get_ip - Returns Tailscale IP addresses for the device
  • dns_status - Shows DNS configuration and MagicDNS status
  • get_status - Shows connection status and peer information (with optional JSON output and active-only filtering)
  • ping_host - Pings a Tailscale peer to test connectivity
  • get_version - Shows version information
  • list_exit_nodes - Lists available exit nodes on your tailnet
  • ip_lookup - Looks up information about a Tailscale IP address (whois)

Resources

The server also exposes three commonly-accessed pieces of information as resources:

  • tailscale://status - Current status
  • tailscale://ip - Device IP addresses
  • tailscale://version - Version information

Key Design Decisions

  • Safety First: All implemented commands are read-only or diagnostic, ensuring no configuration changes can be made
  • Error Handling: Comprehensive error handling for missing Tailscale installation or command failures
  • Flexible Status: The get_status tool supports both --active and --json flags for different output formats
  • Clean Output: All commands return stripped output for cleaner responses

Usage

To use this server:

  1. Save it as tailscale_server.py
  2. Install with MCP: mcp install tailscale_server.py
  3. Or test it: mcp dev tailscale_server.py

The server will work with any MCP client (like Claude Desktop) and provides safe, read-only access to Tailscale diagnostic information without risk of misconfiguration.

Requirements

  • Python 3.8+
  • Tailscale CLI installed and configured - assumes MacOS with default directory
  • Active Tailscale login session
  • MCP-compatible client

License

MIT License - see the source file for full license text.