convez.ai
MCP ServerDados & AnalyticsIntermediário
questdb

QuestDB MCP Bridge

questdb/mcp-bridge

Conecta agentes de IA ao QuestDB para queries e visualizações

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta agentes de código (Claude Code, Cursor, Codex) ao QuestDB Web Console em execução. O agente obtém ferramentas para criar células de notebook, executar queries SQL e construir gráficos diretamente na sessão já estabelecida do navegador.

Instalação

$npx convez-ai questdb/mcp-bridge

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
2
Acompanhando
0
Saúde
50%
Último commit
há 4 dias
Versão
v0.5.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Executar queries SQL através de agentes de IA
  • Criar e gerenciar notebooks com células de análise
  • Gerar gráficos e visualizações automaticamente
  • Análise de dados em tempo real com suporte de agentes

Veredito

Ferramenta especializada que amplia significativamente as capacidades de agentes de código para trabalhar com dados em QuestDB. Excelente para fluxos de análise automatizados, com setup simples e pairing seguro via token.

README

A tradução para o português deste README ainda está na fila.

@questdb/mcp-bridge

An MCP server that connects coding agents (Claude Code, Codex, Cursor, OpenCode …) to a running QuestDB Web Console. The agent gets tools to create notebook cells, run queries, and build charts. Every action executes in the browser against your already-established QuestDB session.

Setup

Add to your MCP client's config (e.g. ~/.claude/.mcp.json):

{
  "mcpServers": {
    "questdb": {
      "command": "npx",
      "args": ["-y", "@questdb/mcp-bridge"]
    }
  }
}
LabelValueDefault ValueDescription
CONSOLE_ORIGINorigin URLhttp://127.0.0.1:9000QuestDB Web Console origin. 127.0.0.1 and localhost are interchangeable.
MCP_BRIDGE_PORT1–65535auto-allocatedWhen specified, the bridge uses a fixed port. Bridge fails to start if specified port is taken.
LOG_PATHfile path/tmp/questdb-mcp-bridge/<ISO-ts>-<pid>.logOverride the log file location.
LOG_LEVELERROR / WARN / INFO / DEBUGINFODEBUG adds heartbeats and full tool payloads.

Pairing

Before any notebook / chart / SQL tool works, your browser has to pair with the bridge. The agent drives the flow.

When the agent needs to pair, it calls get_pairing_credentials and shows you both:

  • A one-click deep link — open it in the tab showing your Web Console.
  • A WebSocket URL + token — paste into the MCP pill at the bottom of the Web Console if the deep link doesn't land in the right tab.

Either path lands you on a consent prompt. Accept it and the agent's next tool call goes through.

Each bridge run generates a fresh port and pairing token, held only in memory. On restart the old credentials stop working — the agent will surface new ones the next time it needs to pair.

Logs

The bridge writes to stderr and to a log file. Tail the newest:

tail -F "$(ls -t /tmp/questdb-mcp-bridge/*.log | head -1)"

At default INFO:

2026-05-15T12:29:27.142Z [INFO] tool_call: run_query
2026-05-15T12:29:27.318Z [INFO] tool_result: run_query ok
2026-05-15T12:29:28.011Z [ERROR] tool_result: update_cell internal_error timeout after 15000ms

At DEBUG (full payloads as continuation lines):

2026-05-15T12:29:27.142Z [INFO] tool_call: run_query
2026-05-15T12:29:27.142Z [DEBUG]   args: {"query":"SELECT count() FROM trades"}
2026-05-15T12:29:27.318Z [INFO] tool_result: run_query ok
2026-05-15T12:29:27.318Z [DEBUG]   content: [{"type":"text","text":"..."}]

License

Apache-2.0.

Ver o original no GitHub

Bom para

Relacionados