> ## Documentation Index
> Fetch the complete documentation index at: https://supermcp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> SuperMCP is a **comprehensive platform** for creating, deploying, and managing **Model Context Protocol (MCP) connectors** that bridge AI assistants with databases, APIs, and other data sources. Build powerful integrations that enable seamless data access through a unified, standardized interface.
# 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:
Deploy one connector instance and create unlimited isolated MCP servers with different configurations
Each MCP server has its own credentials, connection settings, and security tokens
Share connection pools and resources across servers while maintaining isolation
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:
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
Production-ready connectors for PostgreSQL, MSSQL with connection pooling, async operations, and schema introspection
Securely connect to your data sources with encrypted credential storage and protected token-based authentication
Full Model Context Protocol implementation for standardized tool registration and execution
Intuitive React-based dashboard for managing connectors, servers, tokens, and configurations
Fully containerized with Docker Compose, supporting development and production environments
Intelligent connection pooling with LRU eviction, TTL management, and per-server limits
RESTful API for programmatic access with FastAPI-Users authentication
Single connector managing multiple server instances with independent configurations
Pydantic-based validation with auto-generated forms and type safety
Create custom tools using templates defined by connectors for reusable workflows
Build custom connectors for any data source and share them with your teams
All servers are fully protected by token-based authentication with granular access control
## 🎯 Use Cases
Create isolated database connections for each tenant with dynamic connector instances and secure credential management
Integrate multiple heterogeneous data sources into a unified access layer with standardized tooling
Build a centralized gateway for database access with authentication, rate limiting, and monitoring
Provide developers with easy access to database tools, query execution, and schema exploration
Enable AI assistants to query and interact with databases through standardized MCP protocol
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
Quick setup guide to get SuperMCP running in minutes
Detailed introduction to SuperMCP architecture and concepts
Learn about MCP connectors and how to build your own
Complete API documentation with examples
Local development setup and best practices
Integrate SuperMCP with Cursor, Claude Code, and Windsurf
## 🎓 Learn More
Documentation authoring with MDX
Add syntax-highlighted code samples
Organize your documentation
## 🤝 Community & Support
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](/quickstart) to have SuperMCP running in minutes!
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