Tucano DB

Instalação

Baixe o instalador da sua plataforma na página de download. Binário nativo via Tauri 2, com auto-updater assinado embutido.

• macOS — abra o .dmg (Apple Silicon ou Intel) e arraste pra Aplicativos.
• Windows — rode o .msi ou o .exe de setup (x64).
• Linux — .AppImage (chmod +x e rode) ou .deb.

Conexões & navegação

Conecte-se a vários servidores MongoDB ao mesmo tempo, cada um com sua própria cor. A connection string nunca sai do backend em Rust.

• Multi-servidor — Várias conexões simultâneas, cada uma com uma tag de cor pra você não se perder entre ambientes (dev, staging, prod).
• Connection string — Conecte via mongodb:// ou mongodb+srv://. A string fica só no backend Rust — não vai pro frontend, nem pra nuvem, nem pra telemetria.
• Database picker estilo DataGrip — Escolha exatamente quais bancos mostrar por servidor — sem poluir a sidebar com tudo de uma vez.
• Sidebar em árvore — Servidor → bancos → collections, com contagem de documentos e tamanho em disco ao vivo. Browser de índices por collection.

Query

Editor no estilo NoSQLBooster, com duas linguagens e autocomplete forte.

// Mongo shell
db.users.find({ active: true }).sort({ createdAt: -1 }).limit(20)

db.orders.aggregate([
  { $match: { status: "paid" } },
  { $group: { _id: "$customerId", total: { $sum: "$amount" } } },
])

-- SQL (traduzido pra MongoDB)
SELECT name, email FROM users WHERE active = true LIMIT 20

• Mongo shell — db.coll.find(...), aggregate, count, findOne — a sintaxe que você já conhece, com highlight do CodeMirror 6.
• SQL traduzido — Escreva SELECT ... WHERE ... e o Tucano traduz pra uma query MongoDB. Bom pra quem ainda não domina o shell.
• Autocomplete — Sugestão de campos e operadores enquanto você digita, separada por contexto de conexão/collection.
• Tabs de query — Uma conexão/collection por tab. Painel de queries salvas + histórico completo de tudo que você rodou.

Inspeção & edição

Três visões por result set e CRUD completo, sempre com confirmação nas ações destrutivas.

• Tree · Table · JSON — Três formas de ver o mesmo resultado. Tipos BSON coloridos (ObjectId, Date, Int32, Long, Decimal128…) com fidelidade total de Extended JSON.
• Table view — Índice de linha fixo, colunas redimensionáveis, clique pra ordenar, rótulo de tipo no header. Passe o mouse num ObjectId pra ver a data embutida.
• CRUD completo — Inserir, editar, duplicar e apagar documentos — sempre com confirmação. Copie chave, valor, ambos, ou o documento inteiro.
• Ações de collection — Criar, renomear, dropar, duplicar-com-rename. Criar e dropar índices direto pela UI.

Segurança & analytics

Histórico local estilo Studio 3T e um dashboard de Overview por servidor.

• Histórico / backup — Estados de pré-update e pré-delete são gravados localmente (SQLite) e podem ser restaurados. Errou um update? Volta.
• Overview do servidor — Dashboard com versão, uptime, conexões, contadores de operação, memória, rede, tamanho de dados/storage e bancos por tamanho.
• Contagem & paginação — Contagem filtrada + total geral em cada result set, com paginação. Sem surpresa sobre quantos documentos a query tocou.

O app

Local-first, leve e sem firula — a mesma filosofia do Tucano Proxy.

• Temas & idiomas — Dark / Light / System com o acento teal da marca. Localizado em Inglês, Português (Brasil) e Español (termos técnicos como Run, ObjectId e nomes de tipos BSON ficam em inglês).
• Exportação — Exporte result sets em CSV, XLSX ou JSON. Timezone e formato de data configuráveis, page size padrão e script inicial customizável.
• Auto-updater — Atualizações assinadas via GitHub, direto no app. Você não precisa caçar a release nova toda vez.

tucano-db-mcp — servidor MCP

O tucano-db-mcp expõe a sua instância do Tucano DB a clientes LLM (Claude Desktop, Claude Code, OpenCode, Codex) via Model Context Protocol. Com a bridge MCP ligada no app, o agente lista conexões, navega bancos e collections, e busca documentos — tudo somente leitura, via stdio.

Pré-requisitos

• Tucano DB aberto com a bridge MCP ligada (Configurações → MCP) e ao menos uma conexão ativa.
• Node.js 20+ no cliente que vai rodar o servidor MCP.
• Token Bearer copiado de Configurações → MCP do app.

Instalação

Recomendado via npx pra o cliente sempre pegar a versão mais recente. Cole no config MCP:

{
  "mcpServers": {
    "tucano-db": {
      "command": "npx",
      "args": ["-y", "tucano-db-mcp"],
      "env": {
        "TUCANO_DB_TOKEN": "paste-the-token-from-tucano-db-settings"
      }
    }
  }
}

Variáveis de ambiente

• TUCANO_DB_TOKEN — obrigatório. Bearer token gerado pelo app.
• TUCANO_DB_BRIDGE — opcional. URL da bridge (padrão http://127.0.0.1:7900). Só mude se alterou a porta.

Ferramentas expostas

Endpoints da bridge HTTP

Pra integrações além do MCP, a bridge é uma API HTTP local (axum) em 127.0.0.1:7900. Todos os endpoints exigem Authorization: Bearer <token> e são somente leitura.

FAQ