使用说明
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代币
- 登录地址: admin.vps.org
- 首选 账户→ 开发者 (直接的联系)
- 创建新的API令牌
- 复制令牌(以开头
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
许可证
麻省理工学院