Bauplan
Repository hosting the open source Bauplan MCP server
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
Maintainer
Works with
Installation
Manual Installation
npx bauplanConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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-serverInstall dependencies with uv
Use uv to synchronise the project dependencies into an isolated environment.
uv syncStart 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-httpRegister 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/mcpRegister 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>/mcpVerify 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.
Bauplan Alternatives — Similar Data Science & ML Servers
Looking for alternatives to Bauplan? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.
Ultrarag
★ 5.6kA Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines
RocketRide
★ 3.1k📇 🏠 - MCP server that exposes RocketRide AI pipelines as t
Aix Db
★ 2.1kAix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言到数据洞察的端到端转换。
NeMo Data Designer
★ 1.9k🎨 NeMo Data Designer: Generate high-quality synthetic data from scratch or from seed data.
PaperBanana
★ 1.7kOpen source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.
MiniMax
★ 1.5kBridges MiniMax AI capabilities to the Model Context Protocol, enabling AI agents to perform image understanding, text-to-image generation, and speech synthesis. It provides a standardized interface for accessing MiniMax's core tools via JSON-RPC.
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.
Set Up Bauplan in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.