convez.ai
MCP ServerDados & AnalyticsIntermediário
deltaforge-org

DeltaForge MCP Server

deltaforge-org/delta-forge-mcp

Análise SQL, catálogo e linhagem de dados para IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra análise SQL, catálogo e rastreamento de linhagem de dados ao Claude, Cursor e outros clientes MCP. Oferece validação de SQL, exploração de catálogos, análise de pipelines e busca em documentação, tudo sem sair do chat.

Instalação

$npx convez-ai deltaforge-org/delta-forge-mcp

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
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 4 meses
Versão
v1.2.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Validar e explicar consultas SQL em tempo real
  • Rastrear linhagem de colunas em pipelines de dados
  • Explorar catálogos de esquemas, tabelas e vistas
  • Inspecionar status e agendamentos de pipelines
  • Gerar DDL para tabelas externas

Veredito

MCP robusto para engenheiros de dados que usam DeltaForge. Requer controle de acesso via token e control plane, mas integração nativa com Claude/Cursor é fluida e bem documentada. Ideal para times que já operam DeltaForge.

README

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

DeltaForge MCP Server

A Model Context Protocol (MCP) server that gives AI assistants (Claude, Cursor, Codex, and any MCP client) first-class tools for DeltaForge: SQL analysis and validation, command and documentation lookup, catalog and lineage browsing, and pipeline inspection. The assistant can validate and explain SQL, trace column-level lineage, search the docs, and read your catalog without you leaving the chat.

Learn more at deltaforge.org.

DeltaForge is commercial software with a free Community license. See deltaforge.org/pricing.

Run

npx deltaforge-mcp

On first run the native server binary for your platform is downloaded from this repo's Releases and cached. Alternatively, install the native binary directly from the Releases page (Linux/macOS tarball, Windows zip).

Use with Claude

The server speaks MCP over stdio. Add it to Claude Desktop's config (claude_desktop_config.json, reachable via Settings -> Developer -> Edit Config), then restart Claude:

{
  "mcpServers": {
    "deltaforge": {
      "command": "npx",
      "args": ["-y", "deltaforge-mcp"],
      "env": {
        "DELTAFORGE_CONTROL_PLANE_URL": "https://control.example.com"
      }
    }
  }
}

For Claude Code (CLI), register it once:

claude mcp add deltaforge -- npx -y deltaforge-mcp

Then ask Claude things like "validate this DeltaForge SQL", "show the lineage of sales.public.orders", or "what schemas are in the catalog".

Use with Codex

Add the server to your Codex config (e.g. ~/.codex/config.toml):

[mcp_servers.deltaforge]
command = "npx"
args = ["-y", "deltaforge-mcp"]
env = { DELTAFORGE_CONTROL_PLANE_URL = "https://control.example.com" }

Other clients

Cursor (~/.cursor/mcp.json) and any other MCP client use the same npx deltaforge-mcp command. Ready-to-paste snippets for Claude, Codex, and Cursor are in client-config/.

Connect to your control plane

The SQL-analysis and documentation tools work offline. The catalog, lineage, and pipeline tools need a DeltaForge control plane. Configure it from the assistant via the configure_control_plane tool, or set:

  • DELTAFORGE_CONTROL_PLANE_URL: control-plane URL
  • a session token / personal access token (df_pat_...) when prompted

Auth uses a device-authorization flow with automatic token refresh.

Tools

About 60 tools, grouped by area:

  • SQL analysis: validate syntax, explain a query, classify statements, extract tables, column-level lineage, format SQL, generate external-table DDL.
  • Docs and commands: list commands, get command syntax, search the docs, and format-specific references (Delta, Iceberg, graph, CSV, JSON, XML, Excel, Avro, ORC, Parquet, Protobuf, EDI, healthcare, geospatial, security).
  • Catalog: list zones / schemas / tables / views / external tables, describe objects, column lists, table stats and properties, table history and schema evolution, upstream/downstream lineage.
  • Pipelines and workspace: pipeline status, schedules, pipeline source, workspace files and overview.
  • Demos and CLI: search demos, fetch a demo, generate CLI commands.

What this repo is

A distribution and support home: release binaries, client-config examples, and issue tracking. The MCP server is closed-source; its source is not published here. Issues and questions: github.com/deltaforge-org/delta-forge-mcp/issues.

Ver o original no GitHub

Bom para

Relacionados