Bauplan

v1.0.0Data Science & MLstable

Repository hosting the open source Bauplan MCP server

agent-skillsagentsbauplanlakehousemcp-server
Share:
11
Stars
0
Downloads
0
Weekly
0/5

What is Bauplan?

Bauplan is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to repository hosting the open source bauplan mcp server

Repository hosting the open source Bauplan MCP server

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Repository hosting the open source Bauplan MCP server

Use Cases

Query lakehouse data for analytics and reporting.
Build data pipelines with AI-assisted data exploration.
BauplanLabs

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx bauplan

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Bauplan

Bauplan MCP Server is an open-source Python MCP server that gives AI agents direct access to the Bauplan lakehouse platform. Agents can list tables, query data with SQL, manage branches and tags, run data pipeline jobs, import data, and explore schemas — enabling AI-assisted data engineering workflows on top of Bauplan's git-like versioned data model.

Prerequisites

  • A Bauplan account with a non-admin API key configured in your local default profile
  • uv package manager (recommended) or pip with a virtual environment
  • Python 3.10 or newer
  • An MCP-compatible AI client such as Claude Desktop or Claude Code
1

Clone the repository

Clone the Bauplan MCP server repository to your local machine.

git clone https://github.com/BauplanLabs/bauplan-mcp-server.git
cd bauplan-mcp-server
2

Install dependencies with uv

Use uv to synchronise the project dependencies into an isolated environment.

uv sync
3

Start the MCP server

Start the server using streamable-http transport. The server listens on http://localhost:8000/mcp by default and uses the Bauplan API key from your local default profile.

uv run python main.py --transport streamable-http
4

Register the server with Claude Code

Add the running HTTP server to Claude Code using the mcp add command. Authentication is handled automatically via your default Bauplan profile.

claude mcp add -t http mcp-bauplan http://localhost:8000/mcp
5

Register with a remote server or explicit API key

For remote deployments or CI environments, pass the Bauplan API key as an Authorization header when registering the server.

claude mcp add -t http \
  -H "Authorization: Bearer <your-api-key>" \
  mcp-bauplan https://<remote-host>/mcp
6

Verify the connection

Ask your AI client to list available Bauplan tables or branches. The agent should return results from your Bauplan lakehouse.

Bauplan Examples

Client configuration

Claude Desktop configuration for the Bauplan MCP server running locally with uv. The server must be started separately before the client connects.

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/bauplan-mcp-server",
        "python", "main.py",
        "--transport", "stdio"
      ]
    }
  }
}

Prompts to try

Use these prompts to explore and manipulate your Bauplan lakehouse through the AI agent.

- "List all tables in my Bauplan default namespace"
- "Run this SQL query on the main branch: SELECT * FROM orders LIMIT 20"
- "Show me all branches in my Bauplan project and their latest commit info"
- "Create a new branch called 'feature-analysis' from main"
- "What jobs are currently running in my Bauplan project?"

Troubleshooting Bauplan

Authentication fails with 'no default profile found'

Configure your Bauplan API key by running the Bauplan CLI login command: bauplan login. This creates the default profile that the MCP server reads automatically. Avoid using admin API keys — use a regular user key.

Server starts but Claude Code cannot connect over HTTP

Verify the server is listening by running curl http://localhost:8000/mcp. If it returns an error, check that the --transport streamable-http flag was passed and that port 8000 is not blocked by a firewall. For stdio transport, use the uv run command directly in the config.

uv sync fails with dependency conflicts

Ensure you are using a supported Python version (3.10+). Run uv python install 3.12 to install a compatible Python via uv, then re-run uv sync. Delete the .venv directory first if a stale environment is causing conflicts.

Frequently Asked Questions about Bauplan

What is Bauplan?

Bauplan is a Model Context Protocol (MCP) server that repository hosting the open source bauplan mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Bauplan?

Follow the installation instructions on the Bauplan GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Bauplan?

Bauplan works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Bauplan free to use?

Yes, Bauplan is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "bauplan": { "command": "npx", "args": ["-y", "bauplan"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Bauplan?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides