Hostodo MCP 是 Hostodo 提供的托管式 MCP 服务器,让 AI 助手和兼容 MCP 的客户端通过 Hostodo 的托管 Streamable HTTP MCP 端点管理 Hostodo VPS 基础设施。托管端点:https://api.hostodo.com/mcp;文档:https://hostodo.com/docs/mcp;创建令牌:https://console.hostodo.com/settings/developer-access?tab=tokens&client=claude-code。
用途 Hostodo MCP 面向已认证的 Hostodo 客户,暴露真实的 VPS、账户、支持和 DNS 管理工具,使 MCP 兼容客户端能够以受控方式操作基础设施。
主要能力
- VPS 管理:列出所属 VPS 实例和能力标记;读取详细的虚拟机元数据;列出用于重装工作流的已启用操作系统模板;电源控制(启动、关机、重启、停止、重置);使用明确确认短语重命名 VPS;使用明确确认短语将 VPS 重装为某操作系统模板;查看虚拟机指标、带宽使用、健康检查和事件;在支持的情况下管理快照。
- 代理执行与部署:按虚拟机启用或禁用 MCP/QEMU guest-agent 命令执行;通过 QEMU guest agent 在虚拟机内运行有界同步命令;启动、轮询、读取日志并取消异步虚拟机命令;以 SHA-256 校验上传工件和安装文件到所属虚拟机;在可用的情况下检查部署、服务日志、回滚部署并重启服务。
- 账户与支持工作流:列出发票、查看发票详情并支付发票;列出支付方式和账户余额;在支持的情况下应用账户信用;列出、创建、回复和关闭支持工单;上传工单附件。
- DNS 与访问管理:列出 DNS 区域并管理 DNS 记录;列出和设置 rDNS 记录;列出、添加和删除 SSH 密钥。
使用方式 在 Hostodo Console 中创建 Hostodo MCP 开发者令牌,然后将其作为 bearer token 发送。令牌按作用域授权,应只授予客户端所需的作用域:vms:read — 列出虚拟机、查看虚拟机元数据、列出操作系统模板并读取虚拟机/账户状态;vms:power — 电源操作、重命名、重装及其他改变虚拟机状态的流程;vms:exec — 命令执行、异步命令、服务操作和工件安装流程。
命令执行在每台虚拟机上默认禁用,必须先在该虚拟机上显式启用,exec/工件工具才能运行。
本地运行此 MCP 服务器 该仓库包含一个可运行的小型 MCP 包装器,使 Glama 等注册表能够在生产实现位于 Hostodo 托管 API 的情况下启动并内省 Hostodo MCP。tools/list 无需令牌即可工作,用于注册表评估;真实工具调用需要 HOSTODO_MCP_TOKEN,并会代理到 https://api.hostodo.com/mcp。
MCP 客户端配置 可直接使用托管 Streamable HTTP 端点。Claude Code 示例见仓库文档。
安全与审计 Hostodo MCP 在每次请求时验证令牌作用域和虚拟机所有权。重装、重命名、启用/禁用执行和电源操作等破坏性工作流需要明确的用户意图和/或精确的确认短语。命令执行是每虚拟机选择加入的。MCP 操作会被审计。审计日志经过加密和隐私保护:操作细节保留在 Hostodo 审计日志中,而产品分析仅接收安全元数据。
注册表元数据 该仓库用于向 Glama 和官方 MCP Registry 等 MCP 注册表发布 Hostodo 托管 MCP 服务器的元数据。服务器实现位于 Hostodo 私有的 OdoPanel 后端中。工具元数据存储在 src/tools.json 中,可从实时托管 MCP 端点刷新。
限制
- 仅面向已认证的 Hostodo 客户。
- 真实工具调用需要 HOSTODO_MCP_TOKEN。
- 命令执行默认在每台 VM 上禁用,须显式启用。
- 破坏性操作需要明确用户意图或精确确认短语。
- 关于具体收费、价格、平台支持范围与效果等未在资料中提供的信息,暂未提供。