VPS管理协议服务器

VPS.org MCP服务器是一个连接AI助手与VPS.org API的协议服务器,支持通过自然语言管理VPS服务器、域名、DNS记录、SSH密钥等。

  • by vpsdotorg
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 vpsdotorg/vps-mcp

使用说明

VPS.org MCP服务器

一 MCP(模型上下文协议) 将人工智能助手连接到VPS.org API的服务器。通过自然语言管理VPS服务器、域、DNS记录、SSH密钥等。

安装

# Recommended: run directly with uvx (no install needed)
uvx vps-mcp

# Or install with pip
pip install vps-mcp

获取您的API代币

  1. 登录地址: admin.vps.org
  2. 首选 账户→ 开发者 (直接的联系)
  3. 创建新的API令牌
  4. 复制令牌(以开头 vps_)

配置

克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "vps": {
      "command": "uvx",
      "args": ["vps-mcp"],
      "env": {
        "VPS_API_TOKEN": "vps_your_token_here"
      }
    }
  }
}

克劳德代码

claude mcp add vps -- uvx vps-mcp

然后在运行Claude Code之前设置环境变量:

export VPS_API_TOKEN="vps_your_token_here"

自定义API URL

如果您需要指向不同的API端点:

{
  "env": {
    "VPS_API_TOKEN": "vps_your_token_here",
    "VPS_API_URL": "https://admin.vps.org/api/v1"
  }
}

工具

服务器

工具 说明
list_servers 列出您帐户中的所有VPS服务器
get_server 获取特定服务器的详细信息
create_server 创建新的VPS服务器
delete_server 永久删除服务器
server_power 启动、停止、重新启动或硬停止服务器
create_backup 创建服务器的备份
create_snapshot 创建服务器的快照
resize_server 将服务器调整为不同的计划

领域

工具 说明
list_domains 列出您帐户中的所有域
get_domain 获取有关域的详细信息
search_domains 搜索域名可用性
update_nameservers 更新域的名称服务器
renew_domain 续订域名注册

域名系统

工具 说明
list_dns_zones 列出DNS区域(可选按域筛选)
get_dns_zone 获取包含所有记录的DNS区域
create_dns_zone 创建新的DNS区域
delete_dns_zone 删除DNS区域及其所有记录
create_dns_record 创建DNS记录(a、AAAA、CNAME、MX、TXT等)
update_dns_record 更新现有DNS记录
delete_dns_record 删除DNS记录

信息

工具 说明
list_plans 列出可用的VPS计划及其定价
list_locations 列出可用的数据中心位置
list_operating_systems 列出可用的操作系统选项

SSH密钥

工具 说明
list_ssh_keys 列出您帐户中的所有SSH密钥
add_ssh_key 添加新的SSH公钥
delete_ssh_key 删除SSH密钥

所需的API权限

您的API令牌需要以下权限,具体取决于您使用的工具:

工具 所需权限
服务器工具 servers:*
域工具 domains:*
DNS工具 dns:*
计划/位置/OS工具 servers:read
SSH密钥工具 ssh_keys:*
所有工具 *:*

例子

配置后,您可以向AI助手询问以下问题:

  • “列出我的VPS服务器”
  • “使用入门计划在阿姆斯特丹创建一个新的Ubuntu服务器”
  • “停止服务器abc-123”
  • “为api.example.com添加指向1.2.3.4的A记录”
  • “有什么计划?”
  • “将我的SSH密钥添加到帐户”

发展

# Clone the repo
git clone https://github.com/vpsdotorg/vps-mcp.git
cd vps-mcp

# Install in development mode
uv sync

# Run the server locally
VPS_API_TOKEN=your_token uv run vps-mcp

许可证

麻省理工学院