# 火山引擎

通过 MCP、ve CLI 与产品 Skill 查询、诊断、部署和管理云资源。

- 类型：MCP · Skill · CLI
- 权限：涉及资金
- 门槛：需授权账号、需 API Key
- 官方入口：https://github.com/volcengine/mcp-server
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/volcengine/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。下单、付款前须用户确认。

## 接入前准备

可按任务选择 MCP 或 CLI / Skill 路径。云资源操作需要账号和相应权限；ve 的 Skill 管理要求 1.1.3 以上，具体技能可能要求更高版本。创建、部署或购买资源可能产生费用。

## 接入步骤

1. 如选择 CLI，按官方仓库安装 ve 并检查版本；npm 安装可能同时安装核心 Skill，额外产品工具按需下载。 [官方入口](https://github.com/volcengine/volcengine-cli)
2. 从 Agent Toolkit 的分类清单选择所需 Skill；先用核心发现能力查找，按说明安装专项技能，Ark 等能力可能指向独立产品仓库。 [官方入口](https://github.com/volcengine/volcengine-agent-toolkit)
3. 需要云上操作时，按所选工具说明在本地配置对应账号、凭证和地域；保留下方 MCP 作为另一种接入选项。 [官方入口](https://github.com/volcengine/mcp-server)

## 验证方法

先查看 ve version 或 Agent 的技能清单，再查询已有授权资源；安装成功不等于已完成云服务鉴权。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://github.com/volcengine/volcengine-cli)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "volcengine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-server-ecs>=0.2.0",
        "mcp-server-ecs"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "${VOLCENGINE_ACCESS_KEY}",
        "VOLCENGINE_SECRET_KEY": "${VOLCENGINE_SECRET_KEY}",
        "VOLCENGINE_REGION": "${VOLCENGINE_REGION}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'VOLCENGINE_ACCESS_KEY=${VOLCENGINE_ACCESS_KEY}' --env 'VOLCENGINE_SECRET_KEY=${VOLCENGINE_SECRET_KEY}' --env 'VOLCENGINE_REGION=${VOLCENGINE_REGION}' --transport stdio 'volcengine' -- 'uvx' '--from' 'mcp-server-ecs>=0.2.0' 'mcp-server-ecs'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.volcengine]
command = "uvx"
args = ["--from","mcp-server-ecs>=0.2.0","mcp-server-ecs"]
env_vars = ["VOLCENGINE_ACCESS_KEY","VOLCENGINE_SECRET_KEY","VOLCENGINE_REGION"]
```

### CLI

```
npm install -g @volcengine/cli
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

- [官方 Skill](https://github.com/volcengine/volcengine-agent-toolkit)

## 核验与来源

2026-11-05 核对官方身份：[依据](https://github.com/volcengine/volcengine-cli)。官方组织主页链接官网；同组织维护 MCP、ve CLI 和按产品分类的 Agent Toolkit，含资源部署和交易技能。

官方原文摘录（2026-11-05，来自上述依据）：

```
npm install -g @volcengine/cli
```

- [厂商官方发布依据](https://github.com/volcengine)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)