@sandbaseai/cli

让你的 AI 助手拥有超能力。一行命令，2,000+ AI 模型与 API。

English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português

GitHub Release CI 官方 MCP Registry TensorBlock MCP Index 已收录 开源许可 GitHub Stars

SandBase CLI 安全连接 AI 客户端与模型、API、媒体、数据和沙箱

--- 你的 AI 编程助手很聪明，但它被困在一个盒子里。它不能搜索网页、查看社交媒体、生成图片、或获取实时数据 — 除非你自己逐个对接每个 API。 **SandBase 改变了这一切。** 一行命令，通过 [Model Context Protocol](https://modelcontextprotocol.io) 将你的 Agent 连接到 2,000+ AI 模型与 API。不用管理 API Key，不用折腾配置。 把这一行发给你的 agent，它会自己读取 Skill、运行 `connect`，只需你在浏览器里确认一次登录： ``` set up https://www.sandbase.ai/SKILL.md ``` 想自己动手： ```sh npx -y @sandbaseai/cli@latest connect ``` 在 macOS 或 Linux 上使用官方 Homebrew Formula： ```sh brew install sandbaseai/tap/sandbaseai-cli sandbase connect ``` 想先验证兼容性、暂不登录也不修改本地配置？运行只读目录命令，确认当前版本支持的 25 个客户端： ```sh npx -y @sandbaseai/cli@latest catalog --json ```

SandBase CLI 只读目录审计显示 25 个客户端目标 SandBase CLI doctor 对空白隔离配置按预期安全失败

证据：不写配置的目录审计，以及针对空白隔离配置的受限 doctor 检查。

每个 GitHub 发布版都会随包公布自己的 SHA-256，可据此校验并固定到某个确切版本。 项目已进入[官方 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)，并被[中国独立开发者项目（程序员版）](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github)独立收录。 查看[中文项目页](https://sandbaseai.github.io/cli/zh/)和[中文工作流指南](https://github.com/sandbaseai/cli/discussions/48)。如果 SandBase CLI 对你有帮助，请[给仓库一个 Star](https://github.com/sandbaseai/cli)，让更多开发者发现它。 就这样。你的 Agent 现在能访问一切。 ## SandBase 开源技术栈 - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — 自托管 Agent Runtime，提供持久会话、沙箱隔离、审批、审计与回放。 - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 88 个可安装 Skills，覆盖研究、社交情报、营销和商业工作流。 - **[SandBase for Codex](https://github.com/sandbaseai/sandbase-codex-plugin)** — 官方 Codex 插件，封装 SandBase MCP 桥接器和引导式 Agent Skill。 --- ## 一套可验证的 Agent 工作流 连接后，让 Agent 按以下顺序工作，而不是直接猜测模型名称、输入字段或费用： 1. 使用 `sandbase_discover` 按任务或能力搜索候选模型与 API。 2. 使用 `sandbase_inspect` 读取当前输入 Schema、价格和执行要求。 3. 确认模型、参数和可能费用后，再使用 `sandbase_run` 执行。 4. 对异步任务使用 `sandbase_run_get` 查询状态和结果。 5. 使用 `sandbase_runs` 查看最近运行、状态与实际费用。 6. 使用 `sandbase_account` 检查账户余额。 例如，你可以要求： > 搜索适合生成产品演示图的模型。先比较输入字段和当前价格，只展示候选项，不要执行。 选择模型后再明确要求执行。模型目录、Schema、价格和运行结果都会变化，因此应以工具当次返回的数据为准。不要把示例输出当作实时结果。 --- ## 包含什么 | 分类 | 工具 | 能做什么 | |------|------|----------| | **网页搜索** | Google、Exa、Tavily、Scholar | 实时搜索任何信息 | | **社交媒体** | Twitter/X、YouTube、Reddit、Instagram、TikTok、小红书、微博、B站 | 监控趋势、获取帖子、分析内容 | | **网页抓取** | Firecrawl、Exa Content | 从任何公开网页提取数据 | | **AI 模型** | GPT-4o、Claude、Gemini、DeepSeek、Qwen、Llama | 调用任何模型，无需自己管 Key | | **图像生成** | Flux、DALL-E、Ideogram、Recraft | Logo、插画、原型图 | | **视频生成** | Kling、MiniMax、Runway、Luma | 短视频、动画 | | **音频** | ElevenLabs、Whisper | 文字转语音、语音转文字 | | **电商** | 淘宝、Amazon | 选品调研、价格对比 | | **金融** | 股票行情、公司信息 | 市场研究与分析 | --- ## 支持的客户端（25 个目标） 兼容所有主流 AI 编程工具： | 自动配置 | 手动配置 | |---------|---------| | Cursor、Cursor CLI | ChatGPT | | Claude Code | Claude Desktop | | Codex | | | Kiro IDE、Kiro CLI | | | Windsurf | | | Gemini CLI | | | Amp | | | Warp | | | OpenCode、Qwen Code、Kimi CLI | | | Hermes、OpenClaw | | 无需登录或修改任何文件，即可预览完整兼容性目录： ```sh npx -y @sandbaseai/cli@latest catalog --json ``` ```sh # 一次连接所有检测到的客户端 npx -y @sandbaseai/cli@latest connect # 或者指定某个客户端 npx -y @sandbaseai/cli@latest connect --client cursor ``` ### OpenClaw 快速开始 直接指定 OpenClaw，并在使用前让 CLI 回读验证由 SandBase 管理的 MCP 服务与 Skill： ```sh npx -y @sandbaseai/cli@latest connect --client openclaw npx -y @sandbaseai/cli@latest doctor --client openclaw ``` 当 `doctor` 确认凭证、MCP bridge 和 Skill 均已配置后，重启 OpenClaw， 再用自然语言提出一个需要 SandBase 的请求。如果 OpenClaw 中已经存在一个并非 SandBase 管理、但同样名为 `sandbase` 的 MCP 服务，安装器会保持原样，不会覆盖。 以后若要移除由 SandBase 管理的 MCP 条目和本地凭证： ```sh npx -y @sandbaseai/cli@latest unregister --client openclaw ``` OpenClaw 目前没有受支持的 Skill 移除命令，因此 `unregister` 会明确报告这一限制， 并保留已经验证过身份的 SandBase Skill。 ### Hermes 快速开始 SandBase 可以在同一次授权事务中安装由它管理的 Hermes Skill 和本地 MCP 条目： ```sh npx -y @sandbaseai/cli@latest connect --client hermes npx -y @sandbaseai/cli@latest doctor --client hermes ``` `doctor` 会验证所有权明确的本地凭证、MCP 条目与 Skill。随后重启 Hermes， 在新的客户端会话中确认原生发现，再使用 SandBase Skill 或 MCP 工具。如果已经存在 一个并非 SandBase 管理、但同样名为 `sandbase` 的 MCP 条目，安装器会保持原样。 若要只移除由 SandBase 管理的 Hermes 配置、Skill 和本地凭证，同时保留供其他客户端 共用的 bridge： ```sh npx -y @sandbaseai/cli@latest unregister --client hermes ``` 该集成已被独立收录于 [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) 和 [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges)。 --- ## 工作原理 ``` ┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐ │ 你的 Agent │ MCP │ 本地 Bridge │ HTTPS │ SandBase API │ │ (Cursor 等) │────────▶│ (按需启动) │────────▶│ 2,000+ 模型/API │ │ │◀────────│ │◀────────│ │ └─────────────────┘ └───────────────┘ └────────────────────┘ ``` 1. 运行 `connect` → 浏览器打开授权 → 你点击同意 2. API Key 本地保存（权限 `0600`） 3. 自动为你的客户端写入 MCP 配置 4. Agent 按需调用工具。没有后台进程。 --- ## 价格 - **数据 API（搜索、社交、抓取、电商、金融）免费调用。** - discover、inspect、运行状态、余额、文件上传均免费。 - 模型（LLM、图像、视频、音频）按次或按百万 token 计费。 `sandbase inspect <工具名>` 会显示当前价格，`base_price: 0` 表示免费。价格可能变动，请以实时返回为准。 ## 命令 ### CLI 命令 ```sh sandbase connect [--client ] # 授权 + 配置 sandbase setup # 升级后：刷新本地 bridge 与 Skill，并测试连通性 sandbase doctor [--client ] # 本地检查 + 一次真实的 SandBase 往返请求 sandbase unregister [--client ] # 移除配置 sandbase catalog --json # 列出所有支持的客户端 ``` ### Agent 命令（Shell 通道，与 MCP 工具能力一致） 没有 MCP、或 MCP 会话异常时，Agent 可以直接在 Shell 里使用同一套目录。凭据自动复用 `connect` 的浏览器登录结果（也可用 `SANDBASE_API_KEY` 或 `sandbase keys add -k `）。 ```sh sandbase discover -q "推特搜索" # 搜索；-t api|llm|multimodal|embedding|service sandbase inspect sandbase_twitter_web_search_timeline # 参数、价格、可直接运行的命令 sandbase run sandbase_twitter_web_search_timeline -i '{"keyword":"AI agents"}' sandbase run <视频工具> -i '{"prompt":"..."}' -w -o result.json # 带退避等待完成，结果写入文件 sandbase runs get -r -w -o result.json # 续查长任务，不要重新运行 sandbase runs list | sandbase balance ``` `-j` 输出 JSON；错误格式为 `{"error":{"code","message","hint"}}`，`hint` 给出下一步。退出码：`0` 成功或仍在运行，`1` 失败（含任务失败），`2` 参数错误。 `api.sandbase.ai` 不可达时，CLI 与 MCP bridge 会自动切换到 `www.sandbase.ai`；bridge 会继续展示 SandBase 工具，并返回可执行的错误提示，而不是让客户端丢掉整个 server。 ### MCP 工具（连接后你的 Agent 可以使用） | 工具 | 用途 | |------|------| | `sandbase_discover` | 搜索全部 2,000+ 可用 AI 模型与 API | | `sandbase_inspect` | 获取输入参数、定价和调用模板 | | `sandbase_run` | 执行模型或 API | | `sandbase_run_get` | 轮询异步任务状态/结果（视频生成等） | | `sandbase_runs` | 查看最近的 API 调用记录和费用 | | `sandbase_account` | 查看账户余额（免费，不扣费） | **Agent 自动遵循的调用流程：** ``` discover → inspect → run ``` ``` 1. sandbase_discover(q: "推特搜索") → 找到匹配的工具 2. sandbase_inspect(name: "twitter_timeline") → 获取参数定义 + 定价 3. sandbase_run(name: "twitter_timeline", ...) → 执行并返回数据 ``` --- ## 安全性 - **URL 和 CLI 参数中没有任何密钥** — OAuth device flow + PKCE - **受限文件权限** — 凭据以 `0600` 存储 - **所有权感知更新** — 保留现有 JSONC 注释以及用户自行管理的 MCP 配置项 - **精确回滚** — 失败或执行 `unregister` 时，只移除由 SandBase 创建的配置 - **随时吊销** — [SandBase Dashboard](https://sandbase.ai/console/keys) 一键操作 --- ## 开始使用 ```sh npx -y @sandbaseai/cli@latest connect ``` 然后让你的 Agent 做一些它以前做不到的事。 **[注册免费账号 →](https://sandbase.ai)** 如果 SandBase 帮你节省了配置时间，欢迎[为项目点个 Star](https://github.com/sandbaseai/cli)——这会让更多 Agent 用户发现它。 --- ## 链接 - [SandBase 平台](https://sandbase.ai) - [文档](https://www.sandbase.ai/docs/) - [官方 MCP Registry 收录](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) - [Glama MCP Connector 收录](https://glama.ai/mcp/connectors/io.github.sandbaseai/cli) - [官方 Registry 社区技术展示](https://github.com/modelcontextprotocol/registry/discussions/1584) - 六工具实战指南：[中文](https://github.com/sandbaseai/cli/discussions/48) · [English](https://github.com/sandbaseai/cli/discussions/47) - [VaultPlane MCP 目录收录](https://www.vaultplane.com/server/sandbase-cli) - [AIMCP 目录收录](https://www.aimcp.info/zh/g/522d366e-114b-4d90-9f1a-552b4b3a9c86) - [中国独立开发者项目（程序员版）收录](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github) - [npm 包](https://www.npmjs.com/package/@sandbaseai/cli) - [控制台](https://sandbase.ai/console) ## 开源协议 Apache-2.0