Bauplan

by marcoeg

289 downloads
Not rated
GitHub

About

An MCP server to interact with data and run pipeline using Bauplan

Details

Author
marcoeg
Downloads
289
Categories
Database, Other, Search

- Lists all tables in the configured namespace
- Retrieves the schema of any data table
- Runs SELECT-only SQL queries on tables
- Supports both STDIO and SSE transports
- Configurable query timeout (default 30 seconds)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Bauplan
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via uvx mcp-bauplan and configure it in your Claude Desktop config file with environment variables BAUPLAN_API_KEY, BAUPLAN_BRANCH, and BAUPLAN_NAMESPACE. Optionally set BAUPLAN_TIMEOUT. It supports both STDIO and SSE transports. For SSE, run uvx mcp-bauplan --transport sse --port 9090 with a .env file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bauplan": {
            "mcp-bauplan": {
                "command": "/path/to/uvx",
                "args": [
                    "mcp-bauplan"
                ],
                "env": {
                    "BAUPLAN_API_KEY": "your-api-key",
                    "BAUPLAN_BRANCH": "your-branch",
                    "BAUPLAN_NAMESPACE": "your-namespace",
                    "BAUPLAN_TIMEOUT": "query-timeout-secs"
                }
            }
        }
    }
}

McpServers

{
    "mcp-bauplan": {
        "command": "/path/to/uvx",
        "args": [
            "mcp-bauplan"
        ],
        "env": {
            "BAUPLAN_API_KEY": "your-api-key",
            "BAUPLAN_BRANCH": "your-branch",
            "BAUPLAN_NAMESPACE": "your-namespace",
            "BAUPLAN_TIMEOUT": "query-timeout-secs"
        }
    }
}

A mimimalist Model Context Protocol MCP server to interact with data tables and running Bauplan queries.

Bauplan manages a data store of Iceberg tables in S3.

- Get Bauplan data tables and their schemas in the configured namespace
- Query Bauplan data tables using SQL (SELECT only)

It supports both SSE and STDIO transports.

The server implements the following tools to interact with Bauplan data tables:

- list_tables:

- Lists all the tables in the configured namespace

- Run a SELECT query on the specified table
-

Create _or edit the Claude Desktop configuration file located at:

- On macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mcp-bauplan": { "command": "/path/to/uvx", "args": ["mcp-bauplan"], "env": { "BAUPLAN_API_KEY": "your-api-key", "BAUPLAN_BRANCH": "your-branch", "BAUPLAN_NAMESPACE": "your-namespace", // Optional "BAUPLAN_TIMEOUT": "query-timeout-secs" // default 30 seconds } } } }

-

Replace/path/to/uvxwith the absolute path to theuvxexecutable. Find the path withwhich uvxcommand in a terminal. This ensures that the correct version ofuvxis used when starting the server.

Restart Claude Desktop to apply the changes.

Create a .env file from .env.example and then execute the following command:

$ uvx --env-file /path/to/.env mcp-bauplan --transport sse --port 9090

Note the use ofnvxand notuvxwill fetchmcp-bauplanfrom the default registryhttps://pypi.org.
- Documentation of Bauplan (SDK and Platform) as Resource
- Automation of Bauplan Execution - more commands and run a pipeline
- Query Generation
- Code Generation Using Templates
- Data Governance & Compliance
- Testing & Validation
- Integration Ecosystem

- Python 3.10 or higher.
- A Bauplan API key (
request here).
- uvpackage manager (
installation).

git clone https://github.com/marcoeg/mcp-bauplan cd mcp-nvd

- Create a.envfile in the project root:

BAUPLAN_API_KEY=your-api-key BAUPLAN_BRANCH=your-branch BAUPLAN_NAMESPACE=your-namespace
cd /path/to/the/repo source .env CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector \ uv run mcp-bauplan

Note: omitCLIENT_PORT=8077 SERVER_PORT=8078if the standard ports are not conflicting.

Then open the browser to the URL indicated by the MCP Inspector, typicallyhttp://localhost:8077?proxyPort=8078

Switch freely betweenstdioandssetransport types in the inspector. To usesseyou need to run the server as explained below.

cd /path/to/the/repo source .env uv run mcp-bauplan --transport sse --port 9090

- Runs with SSE transport on port9090by default.

Then open the browser to the URL indicated by the MCP Inspector. Select SSE Transport Type.

Official MCP server for dbt (data build tool) providing integration with dbt Core/Cloud CLI, project metadata discovery, model information, and semantic layer querying capabilities.

Query and analyze data with MotherDuck and local DuckDB

A collection of tools for managing the platform, addressing data quality and reading and writing to Teradata Database.

A read-only MCP server for Avro data sources, powered by the CData JDBC Driver.

Run SQL queries on data in Amazon S3 using AWS Athena.

Production-grade MCP server for Databricks: SQL Warehouses, Jobs API, multi-workspace support.

Visual no-code generator that turns any database into multiple scoped MCP servers — one per access group, with PII masking and fail-closed query scoping built in.

A read-only MCP server by CData that enables LLMs to query live data from EnterpriseDB databases.

A read-only MCP server for MySQL, enabling LLMs to query live data using the CData JDBC Driver.

A read-only MCP server by CData that allows LLMs to query live Salesforce data. Requires the CData JDBC Driver for Salesforce.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.