使用说明
mcp尾秤
MCP服务器，用于通过Claude Code和其他MCP客户端管理您的Tailscale网络（tailnet）。
特性
- 列出设备 -查看尾网中的所有设备及其详细信息
- 设备状态 -检查联机/脱机状态和连接健康状况
- 更新管理 -查看哪些设备有可用的Tailscale客户端更新
- 网络摘要 -获取您的尾网概览统计数据
- 设备搜索 -按ID、名称或主机名查找特定设备
可用工具
| 工具 | 说明 |
|---|---|
tailscale_list_devices |
列出尾网中的所有设备 |
tailscale_get_device |
获取特定设备的详细信息 |
tailscale_list_online_devices |
仅列出在线/连接的设备 |
tailscale_list_offline_devices |
仅列出离线/断开连接的设备 |
tailscale_check_updates |
检查哪些设备需要更新 |
tailscale_device_summary |
获取汇总统计数据（在线/离线，按操作系统等） |
安装
npm install
npm run build
配置
环境变量
TAILSCALE_API_KEY- 必需的.您的Tailscale API密钥来自https://login.tailscale.com/admin/settings/keysTAILSCALE_TAILNET-可选。默认为-（您当前用户的尾网）
获取API密钥
- 首选https://login.tailscale.com/admin/settings/keys
- 点击“生成身份验证密钥”
- 配置：
- 到期：选择期限（1-90天）
- 描述：“MCP服务器”
- 复制密钥（以开头
tskey-api-)
Claude桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"tailscale": {
"command": "node",
"args": ["/absolute/path/to/mcp-tailscale/dist/index.js"],
"env": {
"TAILSCALE_API_KEY": "tskey-api-your-key-here"
}
}
}
}
Claude代码配置
claude mcp add mcp-tailscale --type stdio
claude mcp config mcp-tailscale command "node"
claude mcp config mcp-tailscale args '["'$(pwd)'/dist/index.js"]'
claude mcp config mcp-tailscale env.TAILSCALE_API_KEY "tskey-api-your-key-here"
使用示例
列出所有设备
Can you list all my Tailscale devices?
检查在线设备
Which of my Tailscale devices are currently online?
检查更新
Do any of my Tailscale devices need updates?
获取设备详细信息
Show me details about my device named "COMPY"
网络摘要
Give me a summary of my Tailscale network
发展
# Build
npm run build
# Watch mode
npm run watch
# Test locally
TAILSCALE_API_KEY=your-key node dist/index.js
API权限
此MCP服务器使用只读API调用。确实如此 不 修改您的Tailscale配置。API密钥只需要：
- 设备列表访问
- 设备状态访问
安全说明
- API键区分大小写
- 密钥将根据您设置的持续时间过期
- 安全地存储密钥（永远不要承诺版本控制）
- 使用环境变量或安全配置管理
更新日志
看 更改日志.md 查看版本历史和发行说明。
许可证
MIT许可证-请参阅 许可证 了解详情。
作者
吉姆·克里斯蒂安
- 网站： jimchristan.net
- github： @阿普头孢拉膜囊
