正式版 · v1.0.1

Avola Agent CLI 与 MCP

面向 AI Agent、服务器自动化和分销系统的零依赖命令行工具与本地 stdio MCP。两者都使用你自己账户生成的 Avola API 密钥。

Avola 自有 API 密钥JSON 输出本地 stdio MCPNode.js 18+

1. 安装

curl -fsSL https://avola.uk/agent/avola-agent.mjs \
  -o avola-agent.mjs
node avola-agent.mjs version

CLI 不依赖第三方包，也不会修改你的系统环境。

# PowerShell
$env:AVOLA_API_KEY="avola_live_你的密钥"
node .\avola-agent.mjs doctor

请妥善保管密钥。应放入环境变量或密钥管理器，不要写入提示词、浏览器代码或公开仓库。

命令	用途
`services --search youtube`	读取并筛选当前服务目录。
`balance`	读取密钥关联的 Avola 账户余额。
`order --service ID --link URL --request-id ID`	提交订单；使用唯一请求编号防止重复下单。
`status ORDER_ID [ORDER_ID ...]`	一次查询最多 100 个订单状态。
`doctor`	检查密钥、API 连接、服务目录和余额读取是否正常。

成功结果以 JSON 输出到 stdout；错误以 JSON 输出到 stderr，并返回非零退出码，方便 Agent 判断重试或停止。

node avola-agent.mjs services --category "YouTube"
node avola-agent.mjs status AVO20260714ABCD

下载正式版压缩包后，在 MCP 客户端中通过 node /绝对路径/avola-mcp.mjs 启动，并在进程环境中提供 AVOLA_API_KEY。

{
  "command": "node",
  "args": ["/绝对路径/avola-mcp.mjs"]
}

avola_create_order 默认只做 dry-run；只有 confirm 是 JSON 布尔值 true 时才会下单。MCP 不提供付款或充值工具。

每个密钥只能访问它关联的 Avola 余额和订单。返回内容不会包含供应商身份、供应商服务编号、供应商价格、内部成本、凭证或管理备注。