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 |
获取汇总统计数据(在线/离线,按操作系统等) |
安装```bash
npm install
npm run build
## 配置
### 环境变量
- `TAILSCALE_API_KEY` - **必需的**.您的Tailscale API密钥来自https://login.tailscale.com/admin/settings/keys
- `TAILSCALE_TAILNET` -可选。默认为 `-` (您当前用户的尾网)
### 获取API密钥
1. 首选https://login.tailscale.com/admin/settings/keys
1. 点击“生成身份验证密钥”
1. 配置:
- 到期:选择期限(1-90天)
- 描述:“MCP服务器”
1. 复制密钥(以开头 `tskey-api-`)
## Claude桌面配置
添加到您的 `claude_desktop_config.json`:```json
{
"mcpServers": {
"tailscale": {
"command": "node",
"args": ["/absolute/path/to/mcp-tailscale/dist/index.js"],
"env": {
"TAILSCALE_API_KEY": "tskey-api-your-key-here"
}
}
}
}
Claude代码配置```bash
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
发展```bash
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: @阿普头孢拉膜囊
链接
- npm包
- 尾标API文件
- 模型上下文协议
