使用说明
尾秤MCP
使用您已经使用的AI工具操作您的尾网。 尾秤MCP是一种 FastMCP 3.1.0+ 暴露的服务器 尾秤管理员API 到助手和自动化：设备、DNS、服务、监控、漏斗、尾滴相关流等 一小套组合工具 （每个操作都有很多，这样你的客户端就不会淹没在数百个微小的工具名称中）。可选的 1977年9月 代理工作流(run_agentic_tailnet_workflow)让有能力的主机在以下情况下运行多步流 采样 已配置。可选 网络应用程序 （Vite/React）为人类提供了一个玻璃风格的仪表板： 我的尾网 拓扑结构， 合作伙伴尾网 洞察、帮助和连接状态。
存储库： github/sandraschi/tailscale-mcp
为什么存在
如果你管理一个 尾网，您已经使用了管理控制台和官方API。这个项目将这个表面变成 MCP工具 所以 光标，克劳德桌面，反重力，或任何支持MCP的客户端都可以列出设备、检查DNS、驱动自动化并回答有关网络的问题 结构化响应 （成功标志、错误、提示）而不是特殊的shell脚本。
你留在上面 管理员API 合同：权威参考仍然存在 尾秤API文件MCP服务器添加了固执己见的分组、某些流的持久性、可选 LLM采样 用于多步骤任务，以及可选 浏览器用户界面 用于快速目视检查。
你得到了什么
MCP工具（组合模式）
操作被分为动词主导的领域，而不是几十个一次性工具，例如 manage_tailnet_devices, manage_tailnet_network, monitor_tailnet, manage_taildrop, manage_funnel，以及更多（安全、自动化、报告、集成等）。每个工具都需要一个 operation 这一论点在精神上与避免工具爆炸的其他舰队服务器相似。MCP名称以动词开头；多余的 tailscale_ 未使用前缀，因为此服务器仅是Tailscale。
保险范围包括 设备和用户管理, MagicDNS和网络策略, Tailscale服务（TailVIP） 在暴露的地方， 监控和度量, 漏斗 和 尾滴-相关流（在适用的情况下集成CLI），以及 帮助, 状态，以及 合作伙伴尾网 与合作伙伴共享尾网的组织的摘要。
工具和操作的完整矩阵存在于 docs/TAILSCALE_MCP_PORTMANTEAU_TOOLS.md （有关任何其他参考资料，请参阅文档索引）。
代理工作流（可选）
对于多步自动化， run_agentic_tailnet_workflow 用途 FastMCP采样 （1577年9月）。您可以将服务器指向 本地OpenAI兼容 端点（例如Ollama）通过 TAILSCALE_SAMPLING_*，或让 主机 使用以下命令运行LLM TAILSCALE_SAMPLING_USE_CLIENT_LLM=1详细信息和安全注意事项见 docs/PRD.md.
网络应用程序（可选）
这 网络应用程序 在...之下 web_sota/ 是一个React/Vite前端，采用深色玻璃风格布局。亮点：
- 我的尾网 可视化您的网络（Mermaid拓扑来自
get_tailnet_status，加上装饰 轨道 视图）。 - 合作伙伴尾网 总结 成员与共享用户 以及按登录名分组的设备，与
summarize_partner_tailnets工具。 - 帮助 环境和采样变量，从shell链接。
此仓库的端口遵循舰队 邻接 公约(10820 前端/ 10821 默认情况下为后端）；看见 docs/WEBAPP.md 和 web_sota/start.ps1.
LM Link（尾秤+LM工作室）
这 get_lm_link 该工具提供以下操作控制 LM链接 --Tailscale+LM Studio合作伙伴关系（2026年2月），为远程本地LLM创建加密网格：
| 操作 | CLI等效 | 说明 |
|---|---|---|
status |
lms link status --json |
实时对等体、加载的模型、链接状态 |
enable / disable |
lms link enable/disable |
打开/关闭LM链接 |
set_device_name |
lms link set-device-name |
在链接上重命名此设备 |
set_preferred_device |
lms link set-preferred-device |
将模型请求路由到首选对等端 |
info / readiness |
（静态/尾标API） | 设置文档和尾网连接检查 |
这 LM链接Web应用程序页面 (/lm-link)显示了一个带有对等列表的实时仪表板，
加载的型号徽章、设备重命名和首选设备选择。需要
lms CLI（与LM Studio捆绑或通过 curl -fsSL https://lmstudio.ai/install.sh | bash).
交叉回购：有关模型级管理，请参阅 本地llm mcp 它还探测LM-Link的状态，以获取其提供商健康仪表板。
持久性和可观察性
磁盘存储 （FastMCP 3.1.0）在重启过程中为漏斗、传输和偏好保持持久状态，请参阅 docs/STORAGE_BACKENDS.md.可选 普罗米修斯/格拉法娜/洛基-样式堆栈记录在 文档/监控/ 如果你想在自己的基础设施上实现完全的可观察性。
代理人的技能
当存在时， skills/TAILSCALE_EXPERT.md 暴露为 resource://tailscale/skills 因此，客户端可以在工具旁边加载以操作员为中心的指导。
这是给谁的
- 平台工程师 布线尾网转变为IDE和自动化。
- 运算符 他们想要一个快速的仪表板和MCP来进行更深入的查询。
- 代理 （有适当的允许列表），应该计划多步骤API工作，而不是一次猜测。
需求
你需要一个 尾秤API键 可以使用您的尾网和 尾网名称 密钥的作用域为：
| 变量 | 角色 |
|---|---|
TAILSCALE_API_KEY |
持票人代币来自 管理控制台 |
TAILSCALE_TAILNET |
您的尾网标识符（如控制台/API中所示） |
采样、HTTP传输和日志记录的可选变量记录在 docs/PRD.md 和 .env.example.
如果您是Tailscale本身的新手，请阅读 docs/WHAT_IS_TAILSCALE.md 首先，它解释 尾网与管理员API与客户 用通俗易懂的语言。
快速开始
git clone https://github.com/sandraschi/tailscale-mcp
cd tailscale-mcp
just
这将打开一个交互式仪表板，显示所有可用命令。跑 just bootstrap 要安装依赖项，请执行以下操作 just serve 或 just dev 开始。
手动设置
如果你没有 just 安装：
安装（快速）
完整选项（Claude Desktop JSON、Docker、Webapp）在 docs/INSTALL.md.最小路径 紫外线:
git clone https://github.com/sandraschi/tailscale-mcp.git
cd tailscale-mcp
uv sync
uv run tailscale-mcp
集 TAILSCALE_API_KEY 和 TAILSCALE_TAILNET 在您的环境中或 .env 在开始之前。
文档地图
| 主题 | 文档 |
|---|---|
| 安装、环境、客户端、Webapp | docs/INSTALL.md |
| 尾标概念 | docs/WHAT_IS_TAILSCALE.md |
| 漏斗/尾滴/服务/对等中继——每个都做什么，什么时候使用 | docs/FEATURES.md |
| 产品范围和抽样 | docs/PRD.md |
| Webapp路由和端口 | docs/WEBAPP.md |
| 建筑 | docs/ARCHITECTURE_AND_DESIGN.md |
| Portmanteau工具（深潜） | docs/TAILSCALE_MCP_PORTMANTEAU_TOOLS.md |
| 其他一切 | docs/DOCUMETION_INDEX.md |
| 贡献（紫外线、拉夫、测试） | 贡献.md |
🛡️ 工业级质量堆栈
该项目坚持 索塔14.1 高保真代理编排的工业标准：
- Python（核心）: 拉夫 用于裁剪和格式化。零容忍
print核心处理程序中的语句(T201). - Web应用程序（用户界面）: 生物群系 用于亚毫秒级的起毛。严格
noConsoleLog执行。 - 协议遵从：硬化
stdout/stderr隔离，以确保防崩溃的JSON-RPC通信。 - 自动化: Justfile 所有舰队行动的食谱(
just lint,just fix,just dev). - 安全：通过以下方式进行自动化审计
bandit和safety.
许可证
麻省理工学院见 许可证.
