Dremio Python MCP

@ucesys

About Dremio Python MCP

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "dremio-mcp": {
      "command": "mcp-dremio-server",
      "args": []
    }
  }
}

Tools

Lists all available catalogs in Dremio

Lists all schemas in a specific catalog

Lists all tables in a specific schema

Executes a SQL query against Dremio

Overview

What is Dremio Python MCP?

Dremio Python MCP is a Model Context Protocol (MCP) server that provides a standardized way to interact with Dremio databases, supporting both Dremio Software and Dremio Cloud. It exposes Dremio catalogs, schemas, and tables as MCP Resources and offers tools for listing metadata and executing SQL queries.

How to use Dremio Python MCP?

Install the package with pip install -e . or uv pip install -e .. Create a config.yaml file or set environment variables for Dremio connection details. Run the server with mcp-dremio-server or python run_mcp_server.py. Add the server configuration to your MCP client (e.g., Claude) using the provided JSON snippet.

Key features of Dremio Python MCP

Exposes Dremio catalogs, schemas, and tables as MCP Resources.
Tools: list_catalogs, list_schemas, list_tables, execute_sql.
SQL validation prevents non-read-only queries.
Input validation protects against SQL injection.
Supports username/password and token authentication.
TLS support for secure communication.

Use cases of Dremio Python MCP

Enable an AI assistant to discover and query Dremio databases.
List all catalogs, schemas, and tables available in a Dremio instance.
Execute read-only SQL queries and retrieve structured results.
Integrate Dremio data exploration into MCP‑compatible applications.

FAQ from Dremio Python MCP

What are the runtime requirements?

Python 3.10 or later, a Dremio instance (Cloud or Software), and PyArrow with Flight support.

How do I authenticate to Dremio?

For Dremio Software, provide username and password (with optional TLS). For Dremio Cloud, use a personal access token.

What query limits does the server enforce?

By default, results are limited to 10,000 rows, schema requests to 1,000 columns, and query execution has a 300‑second timeout.

Can I execute write queries like INSERT or UPDATE?

No. The server validates SQL and only permits read‑only queries such as SELECT.

How can I debug the MCP server?

Run the server with the MCP Inspector: npx @modelcontextprotocol/inspector mcp-dremio-server. The Inspector provides a browser‑based debugging interface.

Frequently asked questions