What is dremio-mcp CLAUDE.md?

Project instructions for an MCP server that lets AI assistants work with Dremio data. Dremio is a platform for querying and connecting data sources.

Use them when developing, testing, configuring, or deploying the Dremio MCP server locally or over HTTP.

They explain the repository layout, supported deployment modes, main technologies, configuration approach, and testing setup, so changes can be made in the expected places.

How dremio/dremio-mcp configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to dremio/dremio-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/dremio/dremio-mcp/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/dremio/dremio-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/dremio/dremio-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/dremio/dremio-mcp/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/dremio/dremio-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/dremio/dremio-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/dremio/dremio-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/dremio/dremio-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 785 This file is loaded in full into every session.

When invoked 785 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00785	$0.00785
Opus 5.5	$0.00314	$0.00314
Sonnet 5.5	$0.00157	$0.00157
Haiku 4.5	$0.00078	$0.00078

Measured 2mo ago against content hash e85d87c7177d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

dremio-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 84 lines

How it starts

The opening of the file, as written. The whole thing — 84 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Dremio MCP Server

Project Overview

An MCP (Model Context Protocol) server that enables LLM integration with Dremio. It allows LLMs like Claude to query and interact with Dremio data sources via the MCP protocol. Supports local (stdio) and remote (streaming HTTP) deployment modes.

Tech Stack

Language: Python 3.11+
Package Manager: uv (not pip)
Build System: Hatchling
Framework: FastMCP / FastAPI / Starlette
Key Libraries: mcp, pydantic, structlog, typer, PyJWT, LaunchDarkly SDK
Testing: pytest with pytest-asyncio (strict mode)

Project Structure

src/dremioai/
├── api/              # API clients (Dremio REST, Prometheus, CLI)
│   ├── dremio/       # Dremio API client
│   ├── prometheus/   # Prometheus API client
│   └── cli/          # CLI helpers
├── config/           # Configuration management (YAML-based)
├── servers/          # MCP server implementation
│   ├── mcp.py        # Main MCP server entry point (CLI via typer)
│   ├── jwks_verifier.py  # JWT/JWKS auth verification
│   └── frameworks/   # Framework integrations (langchain, beeai)
├── tools/            # MCP tool definitions
│   └── tools.py      # Base Tools class
├── metrics/          # Prometheus metrics
└── resources/        # MCP resources

Common Commands

# Install dependencies
uv sync

# Run the MCP server
uv run dremio-mcp-server run

# Run with custom config
uv run dremio-mcp-server run --config-file <path>

# Run all tests
uv run pytest tests

# Run a specific test file
uv run pytest tests/test_chart.py

# Manage config
uv run dremio-mcp-server config create dremioai --uri <uri> --pat <pat>
uv run dremio-mcp-server config list --type dremioai

# Build Docker image
docker build -t dremio-mcp:0.1.0 .

Development Guidelines

Follow PEP 8 style guidelines
Use type hints for function arguments and return values
Async-first: tools and server handlers are async (asyncio_mode = strict)
New tools must inherit from the Tools base class in dremioai.tools.tools
Tools are categorized by ToolType: FOR_DATA_PATTERNS, FOR_SELF, FOR_PROMETHEUS
Config is YAML-based, located at ~/.config/dremioai/config.yaml by default
Commit messages start with a JIRA ticket ID (e.g., DX-XXXXX: description)
Branch from main for all changes

Read the full file on GitHub · 84 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 84 lines · 785 tokens per session scan A e85d87c7177d

Subscribe to this mod's changes

dremio-mcp CLAUDE.md is an instructions file published in the GitHub repository dremio/dremio-mcp (53 stars, last pushed 7d ago), licensed Apache-2.0. It adds 785 tokens to every session, about $0.0031 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Backend and APIs Data and AI LLM agentic-ai ai dremio mcp mcp-server

dremio-mcp CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
dremio-mcp CLAUDE.mddremio/dremio-mcp	Instructions file	53	7d ago	Apache-2.0	A	785	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

dremio-mcp: Instructions file for Claude Code