服务器管理协议

用于管理Servers.com专用服务器基础设施的协议,支持AI助手直接与Servers.com API交互,包括查询服务器、管理SSH密钥、配置网络等功能。

  • by serverscom
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 serverscom/serverscom-mcp

使用说明

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

工作流程将:

  1. 为Linux、macOS、Windows(amd64+arm64)构建二进制文件
  2. 创建一个包含存档和校验和的GitHub版本
  3. 发布 @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