SandBase

Ponte CLI open-source e MCP local que conecta agentes de IA a mais de 2.000 modelos de IA através de uma única conta.

Documentação

@sandbaseai/cli

Dê superpoderes ao seu agente de IA. Um comando. Mais de 2.000 modelos de IA e APIs.

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


Seu assistente de codificação com IA é inteligente, mas está preso em uma caixa. Ele não pode pesquisar na web, verificar redes sociais, gerar imagens ou acessar dados em tempo real — a menos que você conecte cada API manualmente.

O SandBase muda isso. Um comando conecta seu agente a mais de 2.000 modelos de IA e APIs através do Model Context Protocol. Sem chaves de API para gerenciar. Sem dores de cabeça com configuração.

Construindo diretamente sobre HTTP em vez de MCP? Comece com o início rápido da API SandBase ou compare a API unificada de LLM, imagem e vídeo com gateways de modelos especializados.

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect

Ou instale a fórmula oficial do Homebrew no macOS ou Linux:

brew install sandbaseai/tap/sandbaseai-cli
sandbase connect

Veja o anúncio de lançamento do Homebrew e evidências de CI para macOS/Linux.

Para uma instalação reproduzível, verifique o arquivo de release imutável antes de executá-lo. O SHA-256 para sandbaseai-cli-0.1.17.tgz é 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

Aprove a autorização do navegador uma vez; cada cliente suportado pode então descobrir, inspecionar e executar os modelos e APIs disponíveis do SandBase através da ponte MCP local.

Quer inspecionar a compatibilidade antes de entrar ou alterar a configuração? O release v0.1.17 do GitHub atual inclui um 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

Evidências capturadas do release imutável v0.1.17: uma auditoria de catálogo somente leitura e uma verificação limitada do doctor contra um perfil isolado vazio.

Usuários do Homebrew podem executar a mesma verificação somente leitura com sandbase catalog --json.

A tag latest do npm atualmente serve a v0.1.14 enquanto a publicação confiável sem token está sendo habilitada. O tarball do release do GitHub é construído a partir da tag imutável v0.1.17; seu SHA-256 é publicado com o release.

Visite a página oficial do projeto SandBase CLI para uma visão geral compacta. Para um passo a passo focado em segurança de detecção de clientes, ferramentas MCP e rollback, leia o guia de configuração do SandBase CLI para 25 clientes. Agentes de IA e instaladores automatizados podem usar as instruções concisas llms-install.md.

Stack Open-Source do SandBase

  • SandBase Harness — runtime de agente auto-hospedado com sessões persistentes, isolamento de sandbox, aprovações, auditoria e replay.
  • SandBase Agent Skills — 88 Skills instaláveis para pesquisa, inteligência social, marketing e fluxos de trabalho de negócios.
  • SandBase for Codex — plugin oficial do Codex que empacota a ponte MCP do SandBase e a Agent Skill guiada; sua verificação de segurança HOL obrigatória passa em main.

Descubra a ponte remota autenticada no Registro MCP oficial, leia seu showcase da comunidade do Registro, ou encontre-o através de Chinese Independent Developer, Awesome MCP, Glama, TensorBlock MCP Index, MCPRepository, VaultPlane, AIMCP, MCP Server Hub, MCP Server Spot, ou do Awesome AI API Proxy. Mantenedores externos mesclaram o SandBase em Awesome Codex CLI, Awesome Agent Skills, e Awesome MCP Server. A integração Hermes está listada independentemente no catálogo de ecossistema Hermes Atlas e como beta em Awesome Hermes Agent. Instale sua Agent Skill sandbase verificada do skills.sh, a listagem sandbaseai/cli/sandbase no SkillsCat, a listagem sandbaseai/cli/sandbase no skills.re, a listagem SandBase verificada 93/100 no vSkill, a listagem SandBase auditada por segurança no Skillstore, ou o snapshot sandbaseai/sandbase versionado no Agent Skill Hub.


Um Fluxo de Trabalho de Agente Verificável

Após conectar, peça ao seu agente para seguir a mesma sequência inspecionável para busca, APIs de dados, modelos de linguagem, geração de imagens, geração de vídeo e outras capacidades do catálogo:

  1. Use sandbase_discover para encontrar candidatos por tarefa ou capacidade.
  2. Use sandbase_inspect para ler o esquema de entrada atual, preços e requisitos de execução.
  3. Confirme o endpoint selecionado, parâmetros e custo possível antes de chamar sandbase_run.
  4. Para trabalho assíncrono, use sandbase_run_get com o run_id retornado em vez de criar uma execução duplicada.
  5. Use sandbase_runs para revisar o status de execuções recentes e o custo registrado.
  6. Use sandbase_account para verificar o saldo atual da conta.

Por exemplo, comece com uma solicitação de descoberta não cobrável:

Encontre modelos de imagem adequados para uma ilustração quadrada de produto. Compare as entradas necessárias e os preços atuais dos dois melhores candidatos. Não execute nenhum dos modelos ainda.

Após revisar a resposta ao vivo, aprove explicitamente o endpoint e as entradas que deseja executar. Entradas de catálogo, esquemas, preços, latência e disponibilidade podem mudar, então use a resposta da ferramenta da sessão atual em vez de um exemplo estático.

Veja o passo a passo completo do Claude Code e Codex ou o guia de fluxo de trabalho em chinês. Para um exemplo ao vivo do catálogo, leia a nota de dogfooding de descobrir e inspecionar o conector GitHub.


O Que Está Incluído

CategoriaFerramentasO Que Você Pode Fazer
Busca na WebGoogle, Exa, Tavily, ScholarPesquise qualquer coisa em tempo real
Redes SociaisTwitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, BilibiliMonitore tendências, puxe posts, analise conteúdo
ScrapingFirecrawl, Exa ContentExtraia dados de qualquer página web pública
Modelos de IAGPT-4o, Claude, Gemini, DeepSeek, Qwen, LlamaExecute qualquer modelo sem gerenciar chaves
Geração de ImagemFlux, DALL-E, Ideogram, RecraftCrie logotipos, ilustrações, mockups
Geração de VídeoKling, MiniMax, Runway, LumaGere clipes curtos e animações
ÁudioElevenLabs, WhisperTexto para fala, transcrição
E-commerceTaobao, AmazonPesquisa de produtos, comparação de preços
FinançasDados de ações, informações de empresasPesquisa e análise de mercado

Clientes Suportados (25 Alvos)

Funciona com todas as principais ferramentas de codificação com IA:

Auto-configuradoConfiguração manual
Cursor, Cursor CLIChatGPT
Claude CodeClaude Desktop
Codex
Kiro IDE, Kiro CLI
Windsurf
Gemini CLI
Amp
Warp
OpenCode, Qwen Code, Kimi CLI
Hermes, OpenClaw

Pré-visualize o catálogo completo de compatibilidade sem entrar ou alterar nenhum arquivo:

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

Início rápido do OpenClaw

Aponte diretamente para o OpenClaw e peça ao CLI para ler de volta o servidor MCP gerenciado e a Skill do SandBase antes de confiar neles:

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

Depois que doctor relatar a credencial, a ponte MCP e a Skill como configuradas, reinicie o OpenClaw e faça uma solicitação em linguagem natural que precise do SandBase. Se o OpenClaw já tiver um servidor MCP não-SandBase chamado sandbase, o instalador o deixa intacto em vez de sobrescrevê-lo. Para remover a entrada MCP gerenciada e a credencial local depois:

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw

O OpenClaw atualmente não expõe um comando suportado de remoção de Skill, então unregister relata essa limitação e deixa a Skill verificada do SandBase instalada.

Início rápido do Hermes

O SandBase pode instalar tanto sua Skill Hermes gerenciada quanto a entrada MCP local em uma única transação de autorização:

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 a credencial local de propriedade, a entrada MCP e a Skill. Reinicie o Hermes para confirmar a descoberta nativa em uma nova sessão de cliente e, em seguida, use a Skill do SandBase ou as ferramentas MCP. Uma entrada MCP pré-existente não-SandBase chamada sandbase é deixada intacta. Para remover apenas a configuração gerenciada do Hermes, a Skill e a credencial local, mantendo a ponte compartilhada para outros clientes:

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes

A integração é listada independentemente por Hermes Atlas e Awesome Hermes Agent.


Como Funciona

┌─────────────────┐         ┌───────────────┐         ┌────────────────────┐
│   Your Agent    │  MCP    │  Local Bridge │  HTTPS  │    SandBase API     │
│  (Cursor, etc.) │────────▶│  (on-demand)  │────────▶│ 2,000+ models/APIs │
│                 │◀────────│               │◀────────│                    │
└─────────────────┘         └───────────────┘         └────────────────────┘
  1. Execute connect → o CLI abre a autenticação no navegador → você aprova
  2. Chave da API salva localmente (permissões de arquivo 0600)
  3. Ponte MCP configurada para seu cliente
  4. O agente chama as ferramentas sob demanda. Sem daemon. Sem processo em segundo plano.

Comandos

Comandos do 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

Ferramentas MCP (disponíveis para seu agente após conectar)

FerramentaPropósito
sandbase_discoverPesquise todos os mais de 2.000 modelos de IA e APIs disponíveis
sandbase_inspectObtenha esquema de entrada, preços e modelo pronto para uso
sandbase_runExecute um modelo ou endpoint de API
sandbase_run_getConsulte o status/resultado de uma execução assíncrona (geração de vídeo, etc.)
sandbase_runsListe suas chamadas de API recentes com detalhamento de custo
sandbase_accountVerifique o saldo da conta (grátis, sem custo)

Fluxo de trabalho 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

Segurança

  • Zero segredos em URLs ou argumentos do CLI — fluxo de dispositivo OAuth com PKCE
  • Permissões de arquivo restritas — Credenciais armazenadas com 0600
  • Atualizações cientes de propriedade — Comentários JSONC existentes e entradas MCP gerenciadas pelo usuário são preservados
  • Rollback exato — Em falha ou unregister, apenas a configuração de propriedade do SandBase é removida
  • Revogue a qualquer momento — Um clique no SandBase Dashboard

Comece Agora

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect

Depois, peça ao seu agente para fazer algo que ele não podia antes.

Crie uma conta gratuita →

Se o SandBase economizar seu tempo de configuração, dê uma estrela no repositório — isso ajuda mais usuários de agentes a descobrirem o projeto.


Links

Comunidade

Listagens selecionadas pela comunidade:

Licença

Apache-2.0