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

GitHub release CI Official MCP Registry Indexed on TensorBlock MCP Index License GitHub stars

SandBase CLI connects AI clients to 2,000+ AI models and APIs


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

Read-only SandBase CLI v0.1.17 catalog audit showing 25 client targets SandBase CLI v0.1.17 doctor failing closed for an empty isolated profile

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:

  1. Usa sandbase_discover para encontrar candidatos por tarea o capacidad.
  2. Usa sandbase_inspect para leer el esquema de entrada actual, precios y requisitos de ejecución.
  3. Confirma el endpoint seleccionado, los parámetros y el costo posible antes de llamar a sandbase_run.
  4. Para trabajo asíncrono, usa sandbase_run_get con el run_id devuelto en lugar de crear una ejecución duplicada.
  5. Usa sandbase_runs para revisar el estado de ejecuciones recientes y el costo registrado.
  6. Usa sandbase_account para 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íaHerramientasQué puedes hacer
Búsqueda webGoogle, Exa, Tavily, ScholarInvestiga cualquier cosa en tiempo real
Redes socialesTwitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, BilibiliMonitorea tendencias, extrae publicaciones, analiza contenido
ScrapingFirecrawl, Exa ContentExtrae datos de cualquier página web pública
Modelos de IAGPT-4o, Claude, Gemini, DeepSeek, Qwen, LlamaEjecuta cualquier modelo sin gestionar claves
Generación de imágenesFlux, DALL-E, Ideogram, RecraftCrea logotipos, ilustraciones, maquetas
Generación de videoKling, MiniMax, Runway, LumaGenera clips cortos y animaciones
AudioElevenLabs, WhisperTexto a voz, transcripción
Comercio electrónicoTaobao, AmazonInvestigación de productos, comparación de precios
FinanzasDatos de acciones, información de empresasInvestigación y análisis de mercado

Clientes compatibles (25 objetivos)

Funciona con todas las principales herramientas de codificación con IA:

Auto-configuradoConfiguración manual
Cursor, Cursor CLIChatGPT
Claude CodeClaude 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 │
│                 │◀────────│               │◀────────│                    │
└─────────────────┘         └───────────────┘         └────────────────────┘
  1. Ejecuta connect → el CLI abre la autenticación del navegador → tú apruebas
  2. La clave de API se guarda localmente (permisos de archivo 0600)
  3. El puente MCP se configura para tu cliente
  4. 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)

HerramientaPropósito
sandbase_discoverBusca entre los más de 2.000 modelos y APIs de IA disponibles
sandbase_inspectObtén el esquema de entrada, precios y plantilla lista para usar
sandbase_runEjecuta un modelo o endpoint de API
sandbase_run_getConsulta el estado/resultado de una ejecución asíncrona (generación de video, etc.)
sandbase_runsLista tus llamadas recientes a la API con desglose de costos
sandbase_accountVerifica 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.

Crea una cuenta gratuita →

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

Comunidad

Listados curados por la comunidad:

Licencia

Apache-2.0