mcp-bauplan

# mcp-bauplan 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. ## Features - 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. ## Tools The server implements the following tools to interact with Bauplan data tables: - `list_tables`: - Lists all the tables in the configured namespace - `get_schema`: - Get the schema of a data tables - `run_query`: - Run a SELECT query on the specified table ## Configuration 1. 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` 2. Add the following: ```json { "mcpServers": { "mcp-nvd": { "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 } } } } ``` 3. Replace `/path/to/uvx` with the absolute path to the `uvx` executable. Find the path with `which uvx` command in a terminal. This ensures that the correct version of `uvx` is used when starting the server. 4. Restart Claude Desktop to apply the changes. ## Development ### Setup 1. **Prerequisites**: - Python 3.10 or higher. - A Bauplan API key ([request here](https://www.bauplanlabs.com/#join)). - `uv` package manager ([installation](https://docs.astral.sh/uv/)). 2. **Clone the Repository**: ```bash git clone https://github.com/marcoeg/mcp-bauplan cd mcp-nvd ``` 3. **Set Environment Variables**: - Create a `.env` file in the project root: ``` BAUPLAN_API_KEY=your-api-key BAUPLAN_BRANCH=your-bra…