MCP Bauplan Server

Provides an MCP server to query Bauplan data tables in Iceberg via SSE or stdio transports.

javascript

3

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "marcoeg-mcp-bauplan": {
      "command": "uvx",
      "args": [
        "mcp-bauplan"
      ],
      "env": {
        "BAUPLAN_BRANCH": "YOUR_BRANCH",
        "BAUPLAN_API_KEY": "YOUR_API_KEY",
        "BAUPLAN_TIMEOUT": "30",
        "BAUPLAN_NAMESPACE": "YOUR_NAMESPACE"
      }
    }
  }
}

This MCP server lets you interact with Bauplan data tables stored as Iceberg tables in S3, enabling you to list tables, inspect their schemas, and run SELECT queries against them using a configurable transport. It supports both SSE and STDIO transports for flexible access from your MCP clients.

How to use

You connect to the MCP server from your MCP client and choose either the standard IO (stdio) transport for local execution or the SSE transport for streaming communication. Practical tasks you can perform include listing all tables in your configured namespace, retrieving a table’s schema, and running SELECT queries against a specific table. Use the commands and endpoints as exposed by your MCP client, pointing to the server as configured in your environment.

How to install

Prerequisites and setup steps are provided to run the server locally and connect via your MCP client.

{
  "mcpServers": {
    "mcp_bauplan": {
      "command": "uvx",
      "args": ["--env-file", "/path/to/.env", "mcp-bauplan", "--transport", "sse", "--port", "9090"],
      "env": {
        "BAUPLAN_API_KEY": "your-api-key",
        "BAUPLAN_BRANCH": "your-branch",
        "BAUPLAN_NAMESPACE": "your-namespace",
        "BAUPLAN_TIMEOUT": "30"
      }
    }
  }
}

This configuration enables you to start the MCP server locally with the SSE transport on port 9090. Adjust the paths and values to match your environment.

## Additional content

Environment and startup notes you will use include creating a .env file that exports the Bauplan credentials and namespace, then launching the server with the proper transport. You can also run the server via a development flow that uses the MCP Inspector for testing and exploration.

## Available tools

### list\_tables

Lists all the tables in the configured namespace.

### get\_schema

Retrieves the schema of a specified table.

### run\_query

Executes a SELECT query on the specified table.