Skip to main content
Glama
shrey715

Polybase MCP

by shrey715
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Polybase MCP

Universal Database Adapter for PostgreSQL, Supabase & MongoDB — built with the Model Context Protocol (MCP).

Features

  • PostgreSQL/Supabase — Connect via SQLAlchemy

  • MongoDB — Connect to MongoDB & Atlas

  • Read-Only Safety — Only SELECT/find queries allowed

  • Docker Ready — Multi-stage build with non-root user

  • Streamable HTTP — Works with Claude Desktop & VS Code

Related MCP server: Supabase MCP Server

Quick Start

Docker (Recommended)

# Build
docker build -t polybase-mcp -f docker/Dockerfile .

# Run
docker run -p 8000:8000 polybase-mcp

Server available at http://localhost:8000/mcp

Local Development

git clone https://github.com/shrey715/polybase-mcp.git
cd polybase-mcp
uv sync
uv run python -m mcp_server.main

MCP Client Config

VS Code (.vscode/mcp.json)

{
    "servers": {
        "polybase-mcp": {
            "url": "http://localhost:8000/mcp",
            "type": "http"
        }
    }
}

Claude Desktop

{
    "mcpServers": {
        "polybase-mcp": {
            "url": "http://localhost:8000/mcp",
            "transport": "http"
        }
    }
}

Available Tools

Tool

Description

connect_db

Connect to PostgreSQL or MongoDB

list_tables

List tables (PG) or collections (Mongo)

get_schema

Get table columns or sample doc structure

query_db

Execute read-only queries

Connection Examples

# PostgreSQL
connect_db("postgresql://user:pass@host:5432/dbname")

# MongoDB
connect_db("mongodb://user:pass@host:27017/dbname")

# MongoDB Atlas
connect_db("mongodb+srv://user:pass@cluster.mongodb.net/dbname")

Query Examples

# PostgreSQL - SQL
query_db("SELECT * FROM users LIMIT 10")

# MongoDB - collection:filter format
query_db("users")                          # all docs
query_db('users:{"active": true}')         # with filter

Environment Variables

Variable

Default

Description

HOST

0.0.0.0

Server bind address

PORT

8000

Server port

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • PostgreSQL

    modelcontextprotocol
    -
    license
    Not graded
    quality
    A
    maintenance
    A Model Context Protocol server that provides read-only access to PostgreSQL databases. This server enables LLMs to inspect database schemas and execute read-only queries.
    93,517 npm
    90,399
    MIT

  • Supabase MCP Server

    NightTrek
    F
    license
    B
    quality
    F
    maintenance
    Enables querying Supabase databases and generating TypeScript types through the Model Context Protocol interface, supporting features like schema selection, column filtering, and pagination.
    2
    14
    -

  • PostgreSQL MCP Server

    jamesg31
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
    93,517 npm
    MIT

  • PostgreSQL MCP Server

    SembojaTech
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
    93,517 npm
    MIT