Tailscale诊断服务器

一个提供Tailscale诊断信息安全只读访问的MCP服务器,用于网络连接检查、设备IP获取、DNS状态查看等功能。

  • by MattSayar
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MattSayar/tailscale-mcp-server

使用说明

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 不同输出格式的标志
  • 清洁输出:所有命令都返回剥离的输出,以获得更清晰的响应

用法

要使用此服务器,请执行以下操作:

  1. 另存为 tailscale_server.py
  2. 使用MCP进行安装: mcp install tailscale_server.py
  3. 或者测试一下: mcp dev tailscale_server.py

服务器将与任何MCP客户端(如Claude Desktop)配合使用,并提供对Tailscale诊断信息的安全、只读访问,而不会出现配置错误的风险。

需求

  • Python 3.8+
  • Tailscale CLI已安装并配置-假定MacOS具有默认目录
  • 主动Tailscale登录会话
  • MCP兼容客户端

许可证

MIT许可证-有关完整的许可证文本,请参阅源文件。