使用说明
Tailscale MCP服务器
MCP(模型上下文协议)服务器,提供对Tailscale诊断信息的安全、只读访问。
已实现的功能
工具
network_check-运行尾标网络检查以诊断网络连接get_ip-返回设备的Tailscale IP地址dns_status-显示DNS配置和MagicDNS状态get_status-显示连接状态和对等信息(可选JSON输出和仅活动过滤)ping_host-ping一个Tailscale对等节点以测试连接get_version-显示版本信息list_exit_nodes-列出尾网上的可用出口节点ip_lookup-查找有关Tailscale IP地址(whois)的信息
资源
服务器还将三条经常访问的信息作为资源公开:
tailscale://status-当前状态tailscale://ip-设备IP地址tailscale://version-版本信息
关键设计决策
- 安全第一:所有执行的命令都是只读或诊断性的,确保无法进行配置更改
- 错误处理:对丢失的尾秤安装或命令失败进行全面的错误处理
- 灵活状态:get_status工具支持这两种
--active和--json不同输出格式的标志 - 清洁输出:所有命令都返回剥离的输出,以获得更清晰的响应
用法
要使用此服务器,请执行以下操作:
- 另存为
tailscale_server.py - 使用MCP进行安装:
mcp install tailscale_server.py - 或者测试一下:
mcp dev tailscale_server.py
服务器将与任何MCP客户端(如Claude Desktop)配合使用,并提供对Tailscale诊断信息的安全、只读访问,而不会出现配置错误的风险。
需求
- Python 3.8+
- Tailscale CLI已安装并配置-假定MacOS具有默认目录
- 主动Tailscale登录会话
- MCP兼容客户端
许可证
MIT许可证-有关完整的许可证文本,请参阅源文件。