serverscom mcp
用于管理的MCP（模型上下文协议）服务器 Servers.com 专用服务器基础设施。使人工智能助手（Claude等）能够直接与Servers.com API交互-查询服务器、管理SSH密钥、配置网络、管理L2段、提供远程块存储、重新安装操作系统等。
快速开始
npx @servers.com/mcp --token your-api-token
# or via env var
SC_TOKEN=your-api-token npx @servers.com/mcp使用Claude Desktop
{
"mcpServers": {
"serverscom": {
"command": "npx",
"args": ["-y", "@servers.com/mcp"],
"env": {
"SC_TOKEN": "your-api-token"
}
}
}
}配置
| 标志 | 环境变量 | 必填 | 默认 | 描述 |
|---|---|---|---|---|
--token, -t | SC_TOKEN | 是 | - | Servers.com API令牌 |
--endpoint, -e | SC_ENDPOINT | 没有 | https://api.servers.com/v1 | 自定义API终结点 |
可用工具
6个类别的73个工具——请参阅 TOOLS.md 以获取完整参考。
异步操作
许多操作是异步的。调用它们后，轮询相关状态字段：
| 操作 | 投票 | 现场观看 |
|---|---|---|
| 功能更改 | list_dedicated_server_features | 特征 status |
| 救援模式 | get_dedicated_server | operational_status |
| 操作系统重新安装 | get_dedicated_server | operational_status |
| 电源变化 | get_dedicated_server | power_status |
operational_status 值： normal → provisioning → installation → entering_rescue_mode → rescue_mode → exiting_rescue_mode → maintenance
许可证
______________________________________________________________________
发展
从源头构建
go build -o serverscom-mcp .释放
通过以下方式自动发布 GoRelease GitHub Actions。按下版本标签以触发管道：
git tag v1.2.3
git push origin v1.2.3工作流程将：
- 为Linux、macOS、Windows（amd64+arm64）构建二进制文件
- 创建一个包含存档和校验和的GitHub版本
- 发布
@servers.com/mcp以及使用npm的平台包 可信发布 （OIDC，没有长期代币）
项目结构
serverscom-mcp/
├── main.go # Entry point
└── internal/tools/
├── tools.go # Tool registration hub, shared helpers
├── hosts.go # list_hosts
├── dedicated_servers.go # Server CRUD and feature management
├── ssh_keys.go # SSH key operations
├── locations.go # Location and infrastructure options
├── power.go # Power management
├── drives.go # Drive slot listing
├── reinstall.go # OS reinstallation
├── networks.go # Network management
├── l2_segments.go # L2 segment management
└── rbs.go # Remote Block Storage