SandBase
CLI de código abierto y puente MCP local que conecta agentes de IA a más de 2,000 modelos de IA a través de una sola cuenta.
Documentación
@sandbaseai/cli
Dale superpoderes a tu agente de IA. Un solo comando. Más de 2.000 modelos y APIs de IA.
English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português
Tu asistente de codificación con IA es inteligente, pero está atrapado en una caja. No puede buscar en la web, consultar redes sociales, generar imágenes ni acceder a datos en tiempo real — a menos que conectes cada API tú mismo.
SandBase cambia eso. Un solo comando conecta tu agente a más de 2.000 modelos y APIs de IA a través del Model Context Protocol. Sin claves de API que gestionar. Sin dolores de cabeza de configuración.
¿Construyendo directamente sobre HTTP en lugar de MCP? Comienza con el inicio rápido de la API de SandBase o compara la API unificada de LLM, imagen y video con pasarelas de modelos especializadas.
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
O instala la fórmula oficial de Homebrew en macOS o Linux:
brew install sandbaseai/tap/sandbaseai-cli
sandbase connect
Consulta el anuncio de lanzamiento de Homebrew y la evidencia de CI para macOS/Linux.
Para una instalación reproducible, verifica el archivo de lanzamiento inmutable antes de
ejecutarlo. El SHA-256 para sandbaseai-cli-0.1.17.tgz es
1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa.
curl -fL -o sandbaseai-cli-0.1.17.tgz \
https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz
echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -
npx -y ./sandbaseai-cli-0.1.17.tgz connect
Aprueba la autorización del navegador una vez; cada cliente compatible puede entonces descubrir, inspeccionar y ejecutar los modelos y APIs de SandBase disponibles a través del puente MCP local.
¿Quieres inspeccionar la compatibilidad antes de iniciar sesión o cambiar la configuración? El
v0.1.17 lanzamiento de GitHub
incluye un catálogo verificado de 25 clientes:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
Evidencia capturada del lanzamiento inmutable v0.1.17: una auditoría de catálogo sin escritura y una verificación de doctor acotada contra un perfil aislado vacío.
Los usuarios de Homebrew pueden ejecutar la misma verificación de solo lectura con sandbase catalog --json.
La etiqueta latest de npm actualmente sirve v0.1.14 mientras se habilita la publicación confiable sin token.
El tarball del lanzamiento de GitHub se construye desde la etiqueta inmutable v0.1.17;
su SHA-256 se publica con el lanzamiento.
Visita la página oficial del proyecto CLI de SandBase para una visión general compacta.
Para un recorrido centrado en la seguridad de la detección de clientes, herramientas MCP y reversión,
lee la guía de configuración del CLI de SandBase para 25 clientes.
Los agentes de IA y los instaladores automatizados pueden usar las instrucciones concisas
llms-install.md.
Pila de código abierto de SandBase
- SandBase Harness — runtime de agente autoalojado con sesiones persistentes, aislamiento de sandbox, aprobaciones, auditoría y reproducción.
- SandBase Agent Skills — 88 Skills instalables para investigación, inteligencia social, marketing y flujos de trabajo empresariales.
- SandBase for Codex — plugin oficial de Codex que empaqueta el puente MCP de SandBase y la Agent Skill guiada; su escaneo de seguridad HOL requerido pasa en
main.
Descubre el puente remoto autenticado en el Registro oficial de MCP,
lee su vitrina comunitaria del Registro, o encuéntralo a través de
Chinese Independent Developer,
Awesome MCP,
Glama,
TensorBlock MCP Index,
MCPRepository,
VaultPlane,
AIMCP,
MCP Server Hub,
MCP Server Spot, o el
Awesome AI API Proxy.
Mantenedores externos han fusionado SandBase en
Awesome Codex CLI,
Awesome Agent Skills, y
Awesome MCP Server.
La integración de Hermes está listada de forma independiente en el
catálogo de ecosistema Hermes Atlas y como beta en
Awesome Hermes Agent.
Instala su
verificado sandbase Agent Skill desde skills.sh,
el listado de sandbaseai/cli/sandbase en SkillsCat,
el listado de sandbaseai/cli/sandbase en skills.re,
el listado verificado 93/100 de SandBase en vSkill,
el listado de SandBase auditado en seguridad en Skillstore,
o la instantánea versionada de sandbaseai/sandbase en Agent Skill Hub.
Un flujo de trabajo de agente verificable
Después de conectarte, pide a tu agente que siga la misma secuencia inspeccionable para búsqueda, APIs de datos, modelos de lenguaje, generación de imágenes, generación de video y otras capacidades del catálogo:
- Usa
sandbase_discoverpara encontrar candidatos por tarea o capacidad. - Usa
sandbase_inspectpara leer el esquema de entrada actual, precios y requisitos de ejecución. - Confirma el endpoint seleccionado, los parámetros y el costo posible antes de llamar
a
sandbase_run. - Para trabajo asíncrono, usa
sandbase_run_getcon elrun_iddevuelto en lugar de crear una ejecución duplicada. - Usa
sandbase_runspara revisar el estado de ejecuciones recientes y el costo registrado. - Usa
sandbase_accountpara verificar el saldo actual de la cuenta.
Por ejemplo, comienza con una solicitud de descubrimiento no facturable:
Encuentra modelos de imagen adecuados para una ilustración de producto cuadrada. Compara las entradas requeridas y los precios actuales de los dos mejores candidatos. No ejecutes ninguno de los modelos todavía.
Después de revisar la respuesta en vivo, aprueba explícitamente el endpoint y las entradas que deseas ejecutar. Las entradas del catálogo, esquemas, precios, latencia y disponibilidad pueden cambiar, así que usa la respuesta de la herramienta de la sesión actual en lugar de un ejemplo estático.
Consulta el recorrido completo de Claude Code y Codex o la guía de flujo de trabajo en chino. Para un ejemplo de catálogo en vivo, lee la nota de dogfooding de descubrir e inspeccionar el conector de GitHub.
Qué hay dentro
| Categoría | Herramientas | Qué puedes hacer |
|---|---|---|
| Búsqueda web | Google, Exa, Tavily, Scholar | Investiga cualquier cosa en tiempo real |
| Redes sociales | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitorea tendencias, extrae publicaciones, analiza contenido |
| Scraping | Firecrawl, Exa Content | Extrae datos de cualquier página web pública |
| Modelos de IA | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Ejecuta cualquier modelo sin gestionar claves |
| Generación de imágenes | Flux, DALL-E, Ideogram, Recraft | Crea logotipos, ilustraciones, maquetas |
| Generación de video | Kling, MiniMax, Runway, Luma | Genera clips cortos y animaciones |
| Audio | ElevenLabs, Whisper | Texto a voz, transcripción |
| Comercio electrónico | Taobao, Amazon | Investigación de productos, comparación de precios |
| Finanzas | Datos de acciones, información de empresas | Investigación y análisis de mercado |
Clientes compatibles (25 objetivos)
Funciona con todas las principales herramientas de codificación con IA:
| Auto-configurado | Configuración manual |
|---|---|
| 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 |
Vista previa del catálogo de compatibilidad completo sin iniciar sesión ni cambiar ningún archivo:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
# Connect all detected clients at once
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
# Or target one specific client
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
Inicio rápido de OpenClaw
Apunta a OpenClaw directamente, luego pide al CLI que lea el servidor MCP gestionado y la SandBase Skill antes de confiar en ellos:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw
Después de que doctor informe la credencial, el puente MCP y la Skill como configurados,
reinicia OpenClaw y haz una solicitud en lenguaje natural que necesite SandBase. Si
OpenClaw ya tiene un servidor MCP que no es de SandBase llamado sandbase, el instalador
lo deja intacto en lugar de sobrescribirlo. Para eliminar la entrada MCP gestionada
y la credencial local más tarde:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw
OpenClaw actualmente no expone un comando compatible para eliminar Skills, por lo que unregister
informa esa limitación y deja la SandBase Skill verificada instalada.
Inicio rápido de Hermes
SandBase puede instalar tanto su Hermes Skill gestionada como la entrada MCP local en una sola transacción de autorización:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes
doctor verifica la credencial local propiedad, la entrada MCP y la Skill. Reinicia
Hermes para confirmar el descubrimiento nativo en una sesión de cliente nueva, luego usa la
SandBase Skill o las herramientas MCP. Una entrada MCP preexistente que no sea de SandBase llamada
sandbase se deja intacta. Para eliminar solo la configuración gestionada de Hermes,
la Skill y la credencial local mientras se conserva el puente compartido para otros clientes:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes
La integración está listada de forma independiente por Hermes Atlas y Awesome Hermes Agent.
Cómo funciona
┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐
│ Your Agent │ MCP │ Local Bridge │ HTTPS │ SandBase API │
│ (Cursor, etc.) │────────▶│ (on-demand) │────────▶│ 2,000+ models/APIs │
│ │◀────────│ │◀────────│ │
└─────────────────┘ └───────────────┘ └────────────────────┘
- Ejecuta
connect→ el CLI abre la autenticación del navegador → tú apruebas - La clave de API se guarda localmente (permisos de archivo
0600) - El puente MCP se configura para tu cliente
- El agente llama a las herramientas bajo demanda. Sin demonio. Sin proceso en segundo plano.
Comandos
Comandos del CLI
sandbase connect [--client <name>] # Authorize + configure
sandbase doctor [--client <name>] # Health check
sandbase unregister [--client <name>] # Remove configuration
sandbase catalog --json # List all supported clients
Herramientas MCP (disponibles para tu agente después de conectarse)
| Herramienta | Propósito |
|---|---|
sandbase_discover | Busca entre los más de 2.000 modelos y APIs de IA disponibles |
sandbase_inspect | Obtén el esquema de entrada, precios y plantilla lista para usar |
sandbase_run | Ejecuta un modelo o endpoint de API |
sandbase_run_get | Consulta el estado/resultado de una ejecución asíncrona (generación de video, etc.) |
sandbase_runs | Lista tus llamadas recientes a la API con desglose de costos |
sandbase_account | Verifica el saldo de la cuenta (gratis, sin costo) |
Flujo de trabajo recomendado:
discover → inspect → run
1. sandbase_discover(q: "twitter search") → find current candidates
2. sandbase_inspect(name: discovered_name) → get schema and pricing
3. sandbase_run(name: discovered_name, input: {...}) → run after confirmation
Seguridad
- Cero secretos en URLs o argumentos del CLI — flujo de dispositivo OAuth con PKCE
- Permisos de archivo restringidos — las credenciales se almacenan con
0600 - Actualizaciones conscientes de propiedad — se conservan los comentarios JSONC existentes y las entradas MCP gestionadas por el usuario
- Reversión exacta — en caso de fallo o
unregister, solo se elimina la configuración propiedad de SandBase - Revoca en cualquier momento — un clic en el SandBase Dashboard
Comienza
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
Luego pide a tu agente que haga algo que no podía hacer antes.
Si SandBase te ahorra tiempo de configuración, dale una estrella al repositorio — ayuda a que más usuarios de agentes descubran el proyecto.
Enlaces
- SandBase Platform
- Documentación
- Guía de configuración del CLI
- Inmersión profunda en el CLI: English · 中文
- Flujo de trabajo práctico de seis herramientas: English · 中文
- Paquete npm
- Plugin oficial de Codex
- Dashboard
Comunidad
- Haz una pregunta o comparte lo que has construido
- Reporta un error reproducible
- Propón una integración o mejora
- Contribuye al CLI de SandBase
Listados curados por la comunidad:
- Escaparate de la comunidad del Registro Oficial
- Directorio MCP de VaultPlane
- Directorio AIMCP
- Awesome MCP
- Awesome AI API Proxy
- Awesome Gemini CLI
- Hermes Atlas
- Awesome Hermes Agent
- Awesome AI Tools
- Awesome MCP Server
- Awesome Agent Cortex
- Awesome AI Agent Tools
- Awesome Codex CLI
Licencia
Apache-2.0

