Helipod

Helipod MCP 服务和技能

通过 AI 编码工具使用 Helipod：用日常语言提出需求，即可部署应用和数据库、运行 VPS 服务、购买域名并编辑 DNS，以及发送邮件。

• MCP 服务（helipod-mcp）：提供 229 个工具，涵盖 Container、Database、VPS、Domain、Email、Account 和 AI API。可用于 Claude Code、Codex、Cursor、VS Code、Windsurf、Claude Desktop 及任何 MCP 客户端。
• 技能（skills/）：提供分步操作手册，让 Agent 按照 Helipod 的预期方式部署、查询价格并确认操作（先查询价格，删除前先确认，失败时读取构建日志）。

各工具的分步指南（Claude Code、Codex、Cursor、VS Code、Gemini CLI、opencode、Windsurf、Claude Desktop、Cline 等）：https://docs.helipod.io/docs/helipod/ai-agents

快速开始：登录（无需密钥）

添加托管服务，然后在浏览器中登录 Helipod；你可以选择工具可使用的产品（Container、VPS、Domain API）和项目，并可随时在 Settings → API keys → Connected apps 中断开连接。

工具	添加	登录
Claude Code	/plugin marketplace add helipodapp/mcp then /plugin install helipod@mcp (or claude mcp add --transport http helipod https://api.helipod.io/mcp)	/mcp → helipod → Authenticate
Codex	[mcp_servers.helipod] url = "https://api.helipod.io/mcp" in ~/.codex/config.toml	codex mcp login helipod
Cursor	{"mcpServers":{"helipod":{"url":"https://api.helipod.io/mcp"}}} in ~/.cursor/mcp.json	Settings → MCP → Needs login
opencode	{"mcp":{"helipod":{"type":"remote","url":"https://api.helipod.io/mcp"}}}	opencode mcp auth helipod
Gemini CLI	{"mcpServers":{"helipod":{"httpUrl":"https://api.helipod.io/mcp"}}}	/mcp auth helipod
VS Code	{"servers":{"helipod":{"type":"http","url":"https://api.helipod.io/mcp"}}} in .vscode/mcp.json	服务启动时会提示
Claude.ai, ChatGPT	使用 URL https://api.helipod.io/mcp 添加自定义连接器	连接时会提示

想使用密钥、本地服务或未列出的工具？请继续阅读。

1. 获取密钥

在 dashboard 中打开一个项目，然后选择 Settings → API keys。选择产品（Container API、Database API、VPS API、Domain API）和访问范围（单个项目或整个账户；Domain API 需要使用整个账户范围的密钥）。密钥以 hel_ 开头。

对于邮件工具，请在密钥上启用 Email API（或登录时勾选此项）。项目 Email 部分中的邮件密钥也仍可用，环境变量名为 HELIPOD_EMAIL_API_KEY。

export HELIPOD_API_KEY=hel_...
export HELIPOD_EMAIL_API_KEY=...   # optional: only if you use a separate email key

试用时，建议先使用仅限单个项目的密钥。

2. 连接工具

此服务是 npm 包 helipod-mcp（需要 Node.js 18 或更高版本）。下面的配置会通过 npx -y helipod-mcp（或已安装的 helipod-mcp 命令）运行，并从环境中传入 HELIPOD_API_KEY。

Claude Code

上面的插件使用托管服务并通过登录进行连接。也可以改用本地服务和密钥：

claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y helipod-mcp

Codex

安装一次即可（Codex 不会等待 MCP 服务启动，因此预先安装好的服务可以在收到第一条消息时立即使用，而 npx 可能会来不及启动）：

npm install -g helipod-mcp

~/.codex/config.toml：

[mcp_servers.helipod]
command = "helipod-mcp"
env_vars = ["HELIPOD_API_KEY", "HELIPOD_EMAIL_API_KEY"]

Cursor

~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "${env:HELIPOD_API_KEY}" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "$HELIPOD_API_KEY" }
    }
  }
}

Gemini CLI 只会在你信任的文件夹中启动 MCP 服务。

opencode

~/.config/opencode/opencode.json：

{
  "mcp": {
    "helipod": {
      "type": "local",
      "command": ["npx", "-y", "helipod-mcp"],
      "environment": { "HELIPOD_API_KEY": "{env:HELIPOD_API_KEY}" }
    }
  }
}

VS Code（Copilot Agent 模式）

.vscode/mcp.json：

{
  "inputs": [{ "id": "helipod-key", "type": "promptString", "description": "Helipod API key", "password": true }],
  "servers": {
    "helipod": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "${input:helipod-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "hel_..." }
    }
  }
}

其他客户端

在环境中设置 HELIPOD_API_KEY，然后运行 npx -y helipod-mcp，将其作为 stdio MCP 服务使用（邮件工具需要启用 Email API，或添加 HELIPOD_EMAIL_API_KEY）。

托管服务（无需安装）

可通过 URL 连接的客户端可以使用 https://api.helipod.io/mcp（Streamable HTTP），并提供 Authorization: Bearer hel_...（同一个密钥或登录信息也可用于 Email API 已启用时的邮件工具；X-Helipod-Email-Key 仍然有效）。工具相同；密钥按请求使用，绝不存储。

claude mcp add --transport http helipod https://api.helipod.io/mcp --header "Authorization: Bearer $HELIPOD_API_KEY"

# Codex: ~/.codex/config.toml
[mcp_servers.helipod]
url = "https://api.helipod.io/mcp"
bearer_token_env_var = "HELIPOD_API_KEY"

面向其他 Agent 的技能

Claude Code 会随插件获取这些技能。对于 Codex、Cursor、Gemini CLI、opencode、GitHub Copilot 以及其他会读取 SKILL.md 文件的 Agent：

npx skills add helipodapp/mcp -g

按提示选择 Agent（或传入 -a codex cursor gemini-cli opencode -y）。不使用 -g 时，技能只会放入当前项目。

3. 提问

• “将此仓库部署到我的 Helipod 项目，并提供 URL。”
• “为此项目创建一个 Postgres 数据库，并将它连接到 api 服务。”
• “上次部署为什么失败了？”
• “tokosaya.id 是否可用？价格是多少？”
• “将 www.tokosaya.id 指向我的 Web 服务。”
• “创建一台 2 GB Ubuntu VPS，并开放 443 端口。”
• “从 [email protected] 给我发送一封测试邮件。”

工具

类别	工具
容器	项目和环境（创建、重命名、删除）、共享项目变量、服务（从镜像、Git 或 Dockerfile 创建，重命名）、部署、部署记录和构建日志、重启、变量、域名及其端口、扩缩容、卷（支持调整大小）、函数代码、密钥文件、日志、指标、模板、多服务堆栈
数据库	托管 Postgres：创建、连接字符串、每个环境的分支、计算设置、套餐升级、用量、实时统计、余额、表、只读查询、SQL 分类和经确认的写入
VPS	套餐、创建、重命名、电源控制、重装、密码、登录信息、终止、续费、升级选项和升级、自动续费、指标、防火墙、端口转发、SSH 密钥和 SSH 开关、快照、备份
域名	搜索、价格、所有者详情、注册、转移、续费（均支持试运行）、DNS 记录、名称服务器、子名称服务器、WHOIS 隐私
邮件	状态、套餐（购买、续费、更改、收件箱附加服务，均支持试运行）、发送、已发送日志、发信域名、模板、联系人、细分群组、主题、群发、抑制列表、Webhook、收件箱
账户	钱包和交易、发票、月度对账单、通知、项目活动、支持工单
AI	模型和价格、余额、用量、指标、AI 密钥（列出、撤销）、充值和自动充值
其他	helipod_api_get，用于读取任何其他已记录的端点（只读）

每个工具都标记为只读、写入或破坏性操作，因此客户端可以在运行风险较高的工具前先询问。收费调用支持试运行，服务会告知 Agent 价格并等待你的确认。

安全

• Agent 只能执行密钥权限允许的操作。请使用仅限项目的密钥，并只启用你需要的产品。
• 付费操作（新建服务、VPS、域名、扩缩容、邮件套餐、AI 充值）会从 Helipod 钱包扣款；工具会先试运行，并在实际调用前征求确认。请保持写入和破坏性工具的审批开启。
• 你可以随时在控制面板中撤销密钥。

配置

变量	默认值
HELIPOD_API_KEY	（容器、VPS、域名必需）
HELIPOD_EMAIL_API_KEY	（可选；启用 Email API 后，邮件工具会使用 HELIPOD_API_KEY）
HELIPOD_API_URL	https://api.helipod.io/api
HELIPOD_EMAIL_API_URL	https://mail.helipod.io/api/email

开发

bun install
bun run typecheck
bun test                       # catalog tests; live tests need HELIPOD_TEST_KEY
bun run build                  # dist/stdio.js, dist/index.js, dist/http.js

文档：https://docs.helipod.io