mcp-bauplan

mcp-bauplan

3

mcp-bauplan is a minimalist MCP server focused on managing and querying Bauplan data tables stored as Iceberg tables in S3. It offers functionality to list tables, get schemas, and execute select queries through configurable transports like SSE and STDIO.

mcp-bauplan

A minimalist Model Context Protocol MCP server designed to interact with data tables and execute Bauplan queries. Bauplan manages a data store of Iceberg tables in S3.

Features

  • Access and manage Bauplan data tables and schemas in the configured namespace.
  • Execute SELECT-only SQL queries.
  • Supports SSE and STDIO transports.

Tools

  • List Tables: Lists all tables in the namespace.
  • Get Schema: Retrieves the schema of data tables.
  • Run Query: Executes a SELECT query on a specified table.

Configuration

  • Configure the Claude Desktop configuration file for server integration.
  • Replace paths and restart to apply changes.

Development

  • Requires Python 3.10+, Bauplan API key, and the uv package manager.
  • Clone the repository, set environment variables, and install dependencies.

Testing

  • Can run with SSE transport, defaulting to port 9090. Open the browser to the MCP Inspector for interaction.