Skip to main content

​
Welcome to SuperMCP

​
🎯 What is SuperMCP?

SuperMCP is a powerful platform that enables you to create multiple isolated MCP servers using a single standalone connector. This unique architecture allows you to:

Multi-Server from One Connector

Deploy one connector instance and create unlimited isolated MCP servers with different configurations

Isolated Configurations

Each MCP server has its own credentials, connection settings, and security tokens

Resource Efficient

Share connection pools and resources across servers while maintaining isolation

Simplified Management

Manage all your database connections from a single connector deployment

​
How It Works

Instead of deploying multiple connector instances for different databases, SuperMCP lets you:
  1. Deploy Once: Set up a single PostgreSQL or MSSQL connector
  2. Create Multiple Servers: Configure as many isolated MCP servers as needed
  3. Independent Access: Each server operates independently with its own tokens and credentials
  4. Centralized Control: Manage everything from one unified dashboard
This approach dramatically reduces infrastructure complexity while providing maximum flexibility for multi-tenant applications, development environments, and enterprise deployments.

​
🏗️ Architecture Overview

SuperMCP consists of three main components working together: SuperMCP System Architecture The architecture diagram above illustrates how the Dashboard and MCP Clients interact with the Application Layer, which then communicates with database connectors (PostgreSQL, MySQL) that manage multiple server instances connected to their respective databases.

​
🚀 Key Features

Database Connectors

Production-ready connectors for PostgreSQL, MSSQL with connection pooling, async operations, and schema introspection

Secure Data Layer

Securely connect to your data sources with encrypted credential storage and protected token-based authentication

MCP Protocol

Full Model Context Protocol implementation for standardized tool registration and execution

Visual Management

Intuitive React-based dashboard for managing connectors, servers, tokens, and configurations

Docker Deployment

Fully containerized with Docker Compose, supporting development and production environments

Connection Pooling

Intelligent connection pooling with LRU eviction, TTL management, and per-server limits

API Integration

RESTful API for programmatic access with FastAPI-Users authentication

Multi-Server Support

Single connector managing multiple server instances with independent configurations

Schema Validation

Pydantic-based validation with auto-generated forms and type safety

Custom Tools

Create custom tools using templates defined by connectors for reusable workflows

Custom Connectors

Build custom connectors for any data source and share them with your teams

Authentication & Authorization

All servers are fully protected by token-based authentication with granular access control

​
🎯 Use Cases

Multi-Tenant Applications

Create isolated database connections for each tenant with dynamic connector instances and secure credential management

Data Integration Hub

Integrate multiple heterogeneous data sources into a unified access layer with standardized tooling

API Gateway

Build a centralized gateway for database access with authentication, rate limiting, and monitoring

Developer Tools

Provide developers with easy access to database tools, query execution, and schema exploration

AI Data Access

Enable AI assistants to query and interact with databases through standardized MCP protocol

DataOps Platform

Create a comprehensive platform for database operations, migrations, and management

​
📚 Core Concepts

​
Connectors

Standalone microservices that implement MCP protocol to interface with specific data sources. Each connector runs independently on its own port.

​
Servers

Instances of connectors with specific configurations (credentials, host, database). One connector can manage multiple servers.

​
Tools

Callable operations exposed by connectors (e.g., list_tables, execute_query, test_connection).

​
Templates

Pre-configured tool patterns with parameter validation for common workflows.

​
Connection Pools

Managed connection pools with automatic cleanup, LRU eviction, and configurable limits.

​
🔒 Security Features

  • Encrypted storage in PostgreSQL
  • Never logged or exposed in responses
  • Secure transmission to connectors
  • Support for environment variables
  • FastAPI-Users authentication
  • Cookie-based sessions
  • JWT token support
  • User role management
  • SSL/TLS for database connections
  • Certificate validation options
  • Encrypted data in transit
  • Secure connection strings
  • Parameterized queries prevent SQL injection
  • Input validation via Pydantic
  • Query timeout limits
  • Permission-based access control

​
📖 Documentation Structure

Getting Started

Quick setup guide to get SuperMCP running in minutes

Introduction

Detailed introduction to SuperMCP architecture and concepts

Connectors Overview

Learn about MCP connectors and how to build your own

API Reference

Complete API documentation with examples

Development Guide

Local development setup and best practices

AI Tools Integration

Integrate SuperMCP with Cursor, Claude Code, and Windsurf

​
🎓 Learn More

Write with MDX

Documentation authoring with MDX

Code Examples

Add syntax-highlighted code samples

Navigation Setup

Organize your documentation

​
🤝 Community & Support

Get Help

Found a bug or have a question? Open an issue on GitHub

​
🌟 Why SuperMCP?

Production Ready: Built with enterprise-grade tools like FastAPI, SQLModel, and PostgreSQL Developer Friendly: Beautiful dashboard, comprehensive docs, and extensive examples Extensible: Easy to add new connectors following provided patterns Performant: Async operations, connection pooling, and optimized queries Secure: Authentication, encryption, and query safety built-in Modern Stack: Latest versions of React, FastAPI, and Python 3.12+
Ready to get started? Follow our Quick Start Guide to have SuperMCP running in minutes!