Tailscale MCP 服务器

一个全面的模型上下文协议（MCP）服务器，用于通过本地 Tailscale CLI 管理 Tailscale

此 MCP 服务器提供了完整的 Tailscale 网络管理功能，通过自然语言命令直接在 Warp 终端中实现。利用本地 tailscale CLI 实现最大功能性和可靠性——无需 API 令牌！

🚀 功能

✨ 以 CLI 为中心的方法

• 🚫 无需 API 令牌：使用您本地认证的 tailscale CLI
• 🔒 最大安全性：继承您的 CLI 权限和认证
• ⚡ 完整功能访问：访问所有 Tailscale CLI 功能
• 🛡️ 可靠性：直接执行 CLI 命令以确保一致的行为

📊 状态与信息

• 设备状态：实时连接状态和对等信息
• 网络分析：内置 netcheck 连接诊断工具
• IP 管理：查看 Tailscale IP 地址和分配情况
• 版本信息：Tailscale 版本和构建详情

🔌 连接管理

• 连接/断开连接：支持 tailscale up/down 的全部选项
• 出口节点：列出、建议和管理出口节点
• 路由管理：发布和接受子网路由
• SSH 集成：启用和管理 SSH 访问

🌐 网络工具

• Tailscale Ping：在 Tailscale 层进行网络测试
• 端口测试：通过 nc 连接到远程端口
• DNS 查询：通过 Tailscale 解析查询 DNS
• 网络诊断：全面的连接分析

📁 文件与驱动器共享

• 文件传输：在设备之间发送和接收文件
• 驱动器共享：跨尾网共享目录
• 文件管理：列出并管理共享内容

🌍 服务与隧道

• 本地服务：在尾网内分享内容
• 互联网隧道：公开服务到公共互联网
• HTTPS 支持：自动 TLS 证书管理
• 后台模式：在后台运行服务

🔐 安全与证书

• TLS 证书：为您的域名生成证书
• 尾网锁定：管理和监控网络安全策略
• 谁是：根据 IP 识别设备和用户

📱 设备管理

• 设备列表：查看所有设备，支持过滤
• 设备详情：全面的设备信息
• 实时状态：在线/离线状态和活动

🔧 配置与设置

• 偏好管理：修改 Tailscale 设置
• Web 接口：启动本地 Web 管理界面
• 更新：检查并安装 Tailscale 更新
• 故障排除：内置的故障排查和错误报告

⚠️ 管理员功能 (需要 API 访问)

• 设备管理：授权、标记、删除
• ACL 管理：访问控制列表策略
• DNS 配置：自定义名称服务器和 MagicDNS
• 身份验证密钥：创建和管理身份验证密钥
• 路由控制：启用/禁用子网路由

📋 先决条件

• Node.js 18.0.0 或更高版本
• Tailscale 已安装并认证在您的系统上
• Warp 终端 支持 MCP
• (可选) 管理员 API 访问 用于高级管理功能

🛠 安装

🍺 Homebrew 安装 (推荐)

单行安装：

curl -fsSL https://raw.githubusercontent.com/TB-Warp/tailscale-mcp/main/scripts/install.sh | bash

或手动：

# 添加 tap
brew tap tb-warp/tailscale-mcp https://github.com/TB-Warp/tailscale-mcp

# 安装 tailscale-mcp
brew install tailscale-mcp

# 运行设置
tailscale-mcp-setup

🐙 手动安装

1. 克隆仓库：

   git clone https://github.com/TB-Warp/tailscale-mcp.git
   cd tailscale-mcp
   

2. 安装依赖项：

   npm install
   

3. 测试安装：

   node test-cli.js
   

🔑 验证 Tailscale CLI 访问

确保 Tailscale 已安装并且您已登录：

# 检查 Tailscale 状态
tailscale status

# 如果未登录，请认证
tailscale login

⚙️ Warp 配置

🍺 使用 Homebrew 安装

在您的 Warp MCP 配置文件中添加以下内容：

{
  "mcpServers": {
    "tailscale": {
      "command": "tailscale-mcp"
    }
  }
}

🐙 使用手动安装

在您的 Warp MCP 配置文件中添加以下内容：

{
  "mcpServers": {
    "tailscale": {
      "command": "node",
      "args": ["/绝对路径/to/tailscale-mcp/src/index.js"]
    }
  }
}

就这样！ 不需要环境变量或 API 令牌——MCP 服务器使用您的本地 Tailscale CLI 认证。

🎯 使用示例

配置完成后，在 Warp 中使用自然语言命令：

状态与信息

# 检查 Tailscale 连接状态
"显示我的 Tailscale 状态"

# 列出我尾网中的所有设备
"列出我的所有 Tailscale 设备"

# 获取我的 Tailscale IP 地址
"我的 Tailscale IP 是什么？"

# 检查网络连接
"运行 Tailscale netcheck"

网络操作

# Ping 另一台设备
"Ping 我的服务器 100.64.1.2"

# 查看谁拥有某个 IP
"谁是 100.64.1.5？"

# 测试 DNS 解析
"通过 Tailscale 查询 example.com 的 DNS"

# 使用选项连接到 Tailscale
"作为出口节点连接到 Tailscale"

文件与内容共享

# 列出收到的文件
"显示我的 Tailscale 文件"

# 将文件发送到另一台设备
"将 report.pdf 发送到 my-server"

# 开始提供本地目录
"在 8080 端口上提供我的网站"

# 将服务暴露到互联网
"将我的应用在 3000 端口暴露到互联网"

高级功能

# 获取 TLS 证书
"获取 my-app.tail2d448.ts.net 的证书"

# 分享一个目录
"分享我的 Documents 文件夹作为 'docs'"

# 查看出口节点
"列出可用的出口节点"

# 启动 Web 接口
"启动 Tailscale Web 接口"

🛠 可用的 MCP 工具

核心 CLI 工具

类别	工具	描述
状态	tailscale_status	连接状态和对等信息
	tailscale_version	Tailscale 版本信息
	tailscale_ip	显示 Tailscale IP 地址
	tailscale_netcheck	网络状况分析
连接	tailscale_up	使用选项连接
	tailscale_down	断开与 Tailscale 的连接
设备	tailscale_list_devices	列出/筛选设备
	tailscale_get_device	获取设备详情
	tailscale_whois	根据 IP 识别设备
网络	tailscale_ping	在 Tailscale 层 Ping
	tailscale_nc	连接到远程端口
DNS	tailscale_dns_status	DNS 配置状态
	tailscale_dns_query	通过 Tailscale 查询 DNS
文件	tailscale_file_list	列出收到的文件
	tailscale_file_send	将文件发送到设备
	tailscale_file_receive	接收/获取文件
SSH	tailscale_ssh_list	列出支持 SSH 的设备
出口节点	tailscale_exit_node_list	列出可用的出口节点
	tailscale_exit_node_suggest	建议最佳出口节点
服务	tailscale_serve_status	显示服务状态
	tailscale_serve_start	开始提供内容
	tailscale_serve_stop	停止提供
隧道	tailscale_funnel_status	显示隧道状态
	tailscale_funnel_start	将服务暴露到互联网
	tailscale_funnel_stop	停止隧道
证书	tailscale_cert	获取 TLS 证书
锁定	tailscale_lock_status	尾网锁定状态
	tailscale_lock_log	显示锁定日志
驱动器	tailscale_drive_list	列出共享驱动器
	tailscale_drive_share	分享目录
	tailscale_drive_unshare	停止分享
配置	tailscale_set	更改偏好设置
	tailscale_web	启动 Web 接口
	tailscale_update	检查/安装更新
认证	tailscale_login	登录账户
	tailscale_logout	注销
	tailscale_switch	切换账户
系统	tailscale_configure	配置功能
	tailscale_syspolicy	诊断策略
	tailscale_bugreport	生成错误报告
	tailscale_metrics	显示指标
	tailscale_licenses	许可证信息

遗留 API 工具 (需要管理员访问)

类别	工具	描述
管理员	tailscale_update_device	更新设备设置
	tailscale_delete_device	删除设备
	tailscale_get_acl	获取 ACL 策略
	tailscale_update_acl	更新 ACL 策略
	tailscale_update_dns	更新 DNS 配置
	tailscale_list_keys	列出认证密钥
	tailscale_create_key	创建新的认证密钥
	tailscale_get_routes	列出子网路由
	tailscale_enable_route	启用路由
	tailscale_disable_route	禁用路由
	tailscale_delete_route	删除路由

🔒 安全注意事项

• ✅ 使用您现有的 Tailscale CLI 认证
• ✅ 无需存储或管理令牌
• ✅ 继承您的本地权限和访问
• ✅ 命令以您的用户权限执行

🐛 故障排除

问题	解决方案
"tailscale: 命令未找到"	安装 Tailscale CLI 并确保它在 PATH 中
"未登录"	运行 tailscale login 进行认证
"MCP 服务器无响应"	验证 Node.js 版本和依赖项
"权限被拒绝"	确保您已登录到 Tailscale

调试步骤

1. 测试 Tailscale CLI：tailscale status
2. 验证安装：node test-cli.js
3. 测试 MCP 服务器：timeout 5s node src/index.js
4. 检查 Warp 日志 以查找 MCP 相关错误

🔄 更新

🍺 Homebrew 更新

brew upgrade tailscale-mcp

🐙 手动更新

cd /路径/to/tailscale-mcp
git pull origin main
npm install

🗑️ 卸载

🍺 Homebrew 卸载

# 快速卸载
curl -fsSL https://raw.githubusercontent.com/TB-Warp/tailscale-mcp/main/scripts/uninstall.sh | bash

# 或手动
brew uninstall tailscale-mcp
brew untap tb-warp/tailscale-mcp

🐙 手动卸载

# 移除克隆的目录
rm -rf /路径/to/tailscale-mcp

# 从 Warp MCP 配置中移除
# (手动编辑您的 MCP 配置文件)

🤝 贡献

欢迎贡献！请：

1. 分叉 该仓库
2. 创建 功能分支
3. 提交 Pull Request

📄 许可证

MIT 许可证 - 详情见 LICENSE 文件。

📞 支持

• 问题：GitHub 问题
• Tailscale API：官方文档

---

由 TB-Warp 团队制作 ❤️