gspark-agent

面向 AI Agent 的 G-spark / HUB 接入工具：CLI + MCP，共用同一套 /v1 客户端。

安装

pip install "gspark-agent[mcp]"
# 或隔离安装
pipx install "gspark-agent[mcp]"

开发（本仓库）：

pip install "./packages/gspark-agent[mcp]"

配置

export GSPARK_API_KEY=sk_xxxx
export GSPARK_BASE_URL=https://api.g-spark.cn   # 或其他节点，如 https://api.hqszh.com

兼容别名：HUB_API_KEY、HUB_BASE_URL。

CLI

gspark apps list --json
gspark apps show video_01 --json
gspark tasks estimate --app video_01 --input prompt="hello" --json
gspark tasks run --app video_01 --input prompt="hello" --wait --json
gspark tasks get <task_id> --json
gspark account balance --json
gspark account ledger --page 1 --size 20 --json

• --json：紧凑单行 JSON（便于 Agent / 管道）
• 默认：缩进 JSON；account ledger 默认为表格

--input 支持 JSON 数组/对象，例如：--input tags='["a","b"]'、--input meta='{"k":1}'。

MCP（Cursor）

见 agent_pack/mcp-config.example.json；控制台「Agent 接入」页可下载完整接入包。

gspark-mcp

Agent Skill

agent_pack/SKILL.md 为全站通用说明书，配合 CLI 使用；无需为每个应用单独复制文档。

许可

Proprietary — 允许安装使用；勿再分发改牌。