IONOS CLOUD MCP Server 是一个实现 Model Context Protocol（MCP）的服务器，用于与 IONOS CLOUD 资源交互，由 IONOS Cloud 团队构建和维护。它把 IONOS CLOUD 账户连接到任何兼容 MCP 的 AI 助手或自主 AI 智能体，例如 Claude Desktop、Cursor、VS Code（GitHub Copilot）、Windsurf、Cline、Continue、OpenCode 等。
用途与定位
该服务器用于通过自然语言提示或程序化智能体循环来列出、检查和审计 IONOS CLOUD 基础设施。它默认只读，开箱即用时每个工具都是检查操作（list_、get_、head_*），因此可以安全地连接到生产账户，也可部署在 CI runner 上的无人值守智能体循环中。
主要能力
- 118 个只读工具，覆盖 7 个 IONOS CLOUD 产品。
- 可选的写入工具共 102 个，覆盖 Compute Engine、Kubernetes、DNS 和 Certificate Manager。写入工具（create_、update_、delete_* 以及 start_、attach_ 等领域动词）只有在设置 IONOS_MCP_TOOL_SCOPE 后才会注册。
- 默认范围为只读，可设置为 read、write 或 destructive 等分级能力。
- 两阶段确认：每个 create_* 和 delete_，以及破坏性操作（stop_、reboot_、suspend_、upgrade_、restore_、detach_、recreate_）和 DNS 区域文件导入均需确认。首次调用不执行变更，而是返回预览（删除操作会给出影响范围摘要）和一次性 confirmation_token（5 分钟有效期，绑定到该目标与操作）；只有携带该令牌的第二次调用才会执行。可逆的单字段变更（update_、start_、attach_、assign_）为单次调用。
- 写入工具带有 MCP 注解（readOnlyHint、destructiveHint、idempotentHint），但强制执行始终在服务器端。
使用方式
安装
通过 Homebrew（macOS 或 Linux）安装；也支持 Docker（linux/amd64、linux/arm64）、预构建二进制（从最新 release 下载对应 OS/arch 的归档，支持 Linux、macOS、Windows 的 amd64 和 arm64）、go install 以及从源码构建。 需要拥有带 API 凭据的 IONOS CLOUD 账户。在 IONOS CLOUD DCD 的 Management → Token Management 中生成令牌；Object Storage 凭据在 Storage & Backup → IONOS CLOUD Object Storage → Key management 中创建。
配置
将服务器添加到 AI 客户端的 MCP 配置中。仅在计划使用 Object Storage 工具时才需要 Object Storage 凭据。
工具加载模式
通过 --load-mode 标志或 IONOS_MCP_LOAD_MODE 环境变量设置，标志优先，默认 eager，解析不区分大小写：
- eager（默认）：所有工具在启动时注册。推荐用于 Claude Code，也是忽略 notifications/tools/list_changed 的客户端（Claude Desktop、claude.ai 连接器、Chrome 中的 Claude、Smithery 扫描器）唯一可用的模式。
- lazy：Compute 和 Object Storage 仅在需要时注册。启动时出现两个哨兵工具（ionos_load_compute_tools、ionos_load_objectstorage_tools），调用任一工具会注册完整产品集合并发出 notifications/tools/list_changed。仅当 MCP 客户端支持该通知且缺少客户端侧模式延迟时使用。
- dynamic（别名 search）：服务器仅暴露三个元工具——ionos_search_tools、ionos_describe_tools 和 ionos_call_tool，模型在运行时通过它们发现并调用完整目录。适用于有硬性工具数量上限且自身没有工具搜索的客户端（如 Cursor 约 40 个工具上限、Windsurf 100 个）。代价是模型必须搜索 → 描述 → 调用，增加额外往返。 服务器会在启动时把有效模式及其来源（flag / env / default）记录到 stderr。
传输方式
默认使用 stdio，这是大多数生成子进程的 MCP 客户端所期望的模式。对于远程或网络部署，可使用 --transport http 或 IONOS_MCP_TRANSPORT=http 切换到 Streamable HTTP 传输；标志优先。--http-addr 或 IONOS_MCP_HTTP_ADDR 指定 HTTP 传输的监听地址，默认 127.0.0.1:8080（仅本地）；使用 :8080 监听所有接口。HTTP 模式没有内置 TLS 或认证，如需在可信网络之外访问，应放在反向代理之后。IONOS_TOKEN 及其他 IONOS CLOUD 凭据无论何种传输方式都会对服务器自身发往 IONOS API 的调用进行认证。
适用场景
文档给出的示例提示包括：成本审计、安全扫描、审计追踪、查找遗忘资源、DNS 正确性检查、证书到期检查、流量峰值调查、入门导览等。每个提示会串联多个 list_* 和 get_* 调用并生成可粘贴到工单、仪表板或文档中的摘要。
限制与注意事项
- 默认只读；写入需显式选择加入。
- 写入操作会创建真实资源并产生真实费用，且立即生效。部分资源即使闲置也会计费（如保留的 IP 块、快照、服务器删除后遗留的卷）。删除同样真实：没有快照则数据不可恢复，已释放的 IP 地址无法再次申请。
- AI 模型决定何时以及多频繁地调用这些工具，可能误读意图、重试超出预期或选择比预想更大的资源。两阶段确认旨在让人类参与其中，但无法阻止配置为自动批准工具调用的客户端，在该设置下模型可自行完成两个阶段。
- 用户对通过这些工具在账户中创建、修改或删除的一切以及产生的费用负责。IONOS 不控制也不对模型如何调用它们、或由此产生的任何成本、数据丢失或中断负责。
- 可通过以下方式降低风险：除非需要写入，否则保持服务器只读；不需要删除时授予 write 而非 destructive；在客户端中要求手动批准工具调用；在返回确认令牌前阅读预览；实验时优先使用非生产账户。
- 工具数量限制：Windsurf 将连接的 MCP 服务器工具总数上限设为 100，Cursor 将所有服务器工具总数上限设为约 40。默认 eager 模式下会超出两者。在 Windsurf 上 lazy 可保持启动表面足够小；在 Cursor（或任何没有自身工具搜索的上限受限客户端）上使用 dynamic 仅呈现三个工具。
其他信息
兼容性：MCP 规范 2024-11-05，构建需要 Go 1.25+，提供 linux/amd64 和 linux/arm64 的 OCI 镜像。可通过 HOME 安装、Docker、预构建二进制、go install 或源码方式使用。该服务器已发布在多个 MCP 注册表和 IDE 市场。相关项目包括 IONOS CLOUD MCP Server 产品文档、IONOS CLOUD AI Model Hub、IONOS CLOUD Documentation MCP。采用 Apache License 2.0。安全漏洞请勿公开提交 issue，可通过 GitHub 私有漏洞报告或发送邮件至 sdk-tooling@ionos.com 报告。
