Tailscale Mcp Server

🚀 Tailscale 模型上下文协议 (MCP) 服务器

Tailscale 模型上下文协议 (MCP) 服务器是一个强大的工具，它为用户提供对 Tailscale 网络的只读访问。借助 MCP 远程过程调用 (RPC) 接口，该服务器能与大型语言模型进行交互，让用户轻松查询网络状态和设备信息，同时确保不会对网络配置造成任何更改。

🚀 快速开始

Tailscale 模型上下文协议 (MCP) 服务器为用户提供了对 Tailscale 网络的只读访问能力。若你想使用该服务器，需满足以下安装要求：

• 操作系统：支持 macOS、Linux（包括 Windows 的 WSL 环境）。
• Go 语言：需要安装 Go 1.20 或更高版本。
• Tailscale CLI：必须安装并可在终端中直接运行。

✨ 主要特性

核心功能

• 网络状态查询：可查看 Tailscale 网络中的所有设备、在线状态及 IP 地址。
• 详细信息检索：获取特定设备的配置详情，如 DERP 服务器位置、版本信息等。
• DNS 和 NAT 设置：检查 MagicDNS 和 UPnP 端口映射的启用状态。

安全特性

• 只读访问：服务器仅提供网络信息查询功能，无法执行任何写入操作。
• 白名单命令：只允许运行预定义的安全命令集。
• 用户权限：所有命令均使用当前用户的权限执行，确保与普通 CLI 使用相同的安全级别。

📦 安装指南

若要安装 Tailscale 模型上下文协议 (MCP) 服务器，需满足以下条件：

• 操作系统：支持 macOS、Linux（包括 Windows 的 WSL 环境）。
• Go 语言：需要安装 Go 1.20 或更高版本。
• Tailscale CLI：必须安装并可在终端中直接运行。

📚 详细文档

安全注意事项

• 访问限制：该服务器仅提供只读访问，不会对网络配置进行任何更改。
• 命令控制：只允许运行经过验证的 Tailscale 命令，严格禁止危险操作。
• 用户权限：所有操作均使用当前用户的权限执行，确保与直接使用 CLI 相同的安全性。

故障排除

服务器未在 Claude Desktop 中显示

1. 检查配置文件中指定的可执行文件路径是否正确。
2. 确认 Tailscale CLI 是否已安装并可在终端中运行。
3. 查看日志文件以获取更多信息：
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log

命令执行失败

1. 确保命令在允许的白名单中。
2. 验证 Tailscale 是否正确配置并已连接。
3. 尝试直接使用 Tailscale CLI 执行相同命令以确认其功能正常。

开发信息

本服务器基于 mcp-go 库构建。若需扩展或修改，请按照以下步骤操作：

1. 克隆代码仓库。
2. 进行所需更改。
3. 使用 go build 构建项目。
4. 使用 Claude Desktop 或其他 MCP 客户端进行测试。

贡献指南

欢迎任何贡献！请随意提出问题或提交拉取请求。

📄 许可证

本项目采用 MIT 许可证。