{"id":34666723,"url":"https://github.com/dhanababum/supermcp","last_synced_at":"2025-12-24T19:03:53.565Z","repository":{"id":328088713,"uuid":"1114181794","full_name":"dhanababum/supermcp","owner":"dhanababum","description":"🚀 SuperMCP - Create multiple isolated MCP servers using a single connector. Build powerful Model Context Protocol integrations for databases (PostgreSQL, MSSQL) with FastAPI backend, React dashboard, and token-based auth. Perfect for multi-tenant apps and AI assistants.","archived":false,"fork":false,"pushed_at":"2025-12-11T03:02:36.000Z","size":988,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-11T19:41:47.709Z","etag":null,"topics":["fastapi","fastmcp","mcp","mcp-client","mcp-server"],"latest_commit_sha":null,"homepage":"https://supermcp.mintlify.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dhanababum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-11T02:39:24.000Z","updated_at":"2025-12-11T11:41:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dhanababum/supermcp","commit_stats":null,"previous_names":["dhanababum/supermcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dhanababum/supermcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhanababum%2Fsupermcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhanababum%2Fsupermcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhanababum%2Fsupermcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhanababum%2Fsupermcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dhanababum","download_url":"https://codeload.github.com/dhanababum/supermcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhanababum%2Fsupermcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28006375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","fastmcp","mcp","mcp-client","mcp-server"],"created_at":"2025-12-24T19:01:24.096Z","updated_at":"2025-12-24T19:03:53.559Z","avatar_url":"https://github.com/dhanababum.png","language":"JavaScript","funding_links":[],"categories":["📚 Projects (2474 total)"],"sub_categories":["MCP Servers"],"readme":"# SuperMCP\n\n\u003e A comprehensive platform for creating, deploying, and managing Model Context Protocol (MCP) connectors that bridge AI assistants with databases, APIs, and other data sources.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.109+-green.svg)](https://fastapi.tiangolo.com/)\n[![React](https://img.shields.io/badge/React-19-blue.svg)](https://reactjs.org/)\n\n## 📹 Introduction Video\n\n[![SuperMCP Introduction](https://img.youtube.com/vi/y44Pjc5p1Zg/0.jpg)](https://www.youtube.com/watch?v=y44Pjc5p1Zg)\n\n## 🎯 What is SuperMCP?\n\nSuperMCP is a **powerful platform** that enables you to create **multiple isolated MCP servers** using a **single standalone connector**. This unique architecture allows you to:\n\n- **Multi-Server from One Connector**: Deploy one connector instance and create unlimited isolated MCP servers with different configurations\n- **Isolated Configurations**: Each MCP server has its own credentials, connection settings, and security tokens\n- **Resource Efficient**: Share connection pools and resources across servers while maintaining isolation\n- **Simplified Management**: Manage all your database connections from a single connector deployment\n\n### How It Works\n\nInstead of deploying multiple connector instances for different databases, SuperMCP lets you:\n\n1. **Deploy Once**: Set up a single PostgreSQL or MSSQL connector\n2. **Create Multiple Servers**: Configure as many isolated MCP servers as needed\n3. **Independent Access**: Each server operates independently with its own tokens and credentials\n4. **Centralized Control**: Manage everything from one unified dashboard\n\nThis approach dramatically reduces infrastructure complexity while providing maximum flexibility for multi-tenant applications, development environments, and enterprise deployments.\n\n## 🏗️ Architecture\n\nSuperMCP consists of three main components working together:\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                     Frontend (React + Tailwind)                 │\n│                      http://localhost:3000                      │\n│  • Connector Management  • Server Configuration                │\n│  • Visual Dashboard      • Real-time Monitoring                │\n└──────────────────────┬──────────────────────────────────────────┘\n                       │\n                       │ REST API\n                       ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                    Backend (FastAPI + SQLModel)                 │\n│                      http://localhost:9000                      │\n│  • User Authentication    • Connector Registry                 │\n│  • Configuration Storage  • API Endpoints                      │\n│  • Server Management      • Token Management                   │\n└──────────────────────┬──────────────────────────────────────────┘\n                       │\n                       │ MCP Protocol\n                       ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                    Connectors (Microservices)                   │\n│  PostgreSQL (:8027) │ MSSQL (:8028) │ Custom Connectors        │\n│  • Connection Pooling  • Async Operations                      │\n│  • Schema Introspection • Query Execution                      │\n│  • Transaction Support  • Tool Registration                    │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n## 🚀 Key Features\n\n### Database \u0026 Integration\n- **Database Connectors**: Production-ready connectors for PostgreSQL, MSSQL with connection pooling, async operations, and schema introspection\n- **MCP Protocol**: Full Model Context Protocol implementation for standardized tool registration and execution\n- **API Integration**: RESTful API for programmatic access with FastAPI-Users authentication\n- **Multi-Server Support**: Single connector managing multiple server instances with independent configurations\n\n### Security \u0026 Management\n- **Secure Data Layer**: Securely connect to your data sources with encrypted credential storage and protected token-based authentication\n- **Authentication \u0026 Authorization**: All servers are fully protected by token-based authentication with granular access control\n- **Visual Management**: Intuitive React-based dashboard for managing connectors, servers, tokens, and configurations\n- **Schema Validation**: Pydantic-based validation with auto-generated forms and type safety\n\n### Performance \u0026 Deployment\n- **Docker Deployment**: Fully containerized with Docker Compose, supporting development and production environments\n- **Connection Pooling**: Intelligent connection pooling with LRU eviction, TTL management, and per-server limits\n- **Custom Tools**: Create custom tools using templates defined by connectors for reusable workflows\n- **Custom Connectors**: Build custom connectors for any data source and share them with your teams\n\n## 🎯 Use Cases\n\n- **Multi-Tenant Applications**: Create isolated database connections for each tenant with dynamic connector instances and secure credential management\n- **Data Integration Hub**: Integrate multiple heterogeneous data sources into a unified access layer with standardized tooling\n- **API Gateway**: Build a centralized gateway for database access with authentication, rate limiting, and monitoring\n- **Developer Tools**: Provide developers with easy access to database tools, query execution, and schema exploration\n- **AI Data Access**: Enable AI assistants to query and interact with databases through standardized MCP protocol\n- **DataOps Platform**: Create a comprehensive platform for database operations, migrations, and management\n\n## 🛠️ Technology Stack\n\n### Backend\n- **FastAPI 0.109+** - Modern Python web framework\n- **SQLModel 0.0.14+** - SQL databases with Python type hints\n- **PostgreSQL 12+** - Database with JSONB support\n- **FastAPI-Users** - Authentication and user management\n- **Alembic** - Database migrations\n- **Pydantic 2.5+** - Data validation and settings\n\n### Frontend\n- **React 19** - UI framework\n- **Tailwind CSS 3** - Utility-first styling\n- **react-jsonschema-form** - Dynamic form generation\n- **Fetch API** - HTTP client for REST calls\n\n### Connectors\n- **FastMCP** - MCP server framework\n- **AsyncPG** - PostgreSQL async driver\n- **aioodbc** - MSSQL async driver\n- **UV** - Fast Python package installer\n\n### DevOps\n- **Docker \u0026 Docker Compose** - Containerization\n- **Caddy** - Reverse proxy and HTTPS\n- **PostgreSQL** - Primary database\n\n## 📚 Core Concepts\n\n### Connectors\nStandalone microservices that implement MCP protocol to interface with specific data sources. Each connector runs independently on its own port.\n\n### Servers\nInstances of connectors with specific configurations (credentials, host, database). One connector can manage multiple servers.\n\n### Tools\nCallable operations exposed by connectors (e.g., `list_tables`, `execute_query`, `test_connection`).\n\n### Templates\nPre-configured tool patterns with parameter validation for common workflows.\n\n### Connection Pools\nManaged connection pools with automatic cleanup, LRU eviction, and configurable limits.\n\n## 🔒 Security Features\n\n### Credential Management\n- Encrypted storage in PostgreSQL\n- Never logged or exposed in responses\n- Secure transmission to connectors\n- Support for environment variables\n\n### Authentication \u0026 Authorization\n- FastAPI-Users authentication\n- Cookie-based sessions\n- JWT token support\n- User role management\n\n### Connection Security\n- SSL/TLS for database connections\n- Certificate validation options\n- Encrypted data in transit\n- Secure connection strings\n\n### Query Safety\n- Parameterized queries prevent SQL injection\n- Input validation via Pydantic\n- Query timeout limits\n- Permission-based access control\n\n## 🚦 Quick Start\n\n### Prerequisites\n\n- Python 3.12+\n- Docker \u0026 Docker Compose\n- UV package manager\n- Node.js 18+\n- PostgreSQL 12+\n\n### Installation\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/dhanababum/supermcp.git\ncd supermcp\n```\n\n2. **Start the Backend**\n```bash\ncd app\nuv sync\nuv run python src/main.py\n# Server runs on http://localhost:9000\n```\n\n3. **Start the Frontend**\n```bash\ncd web\nnpm install\nnpm start\n# Opens http://localhost:3000\n```\n\n4. **Start Connectors**\n```bash\n# PostgreSQL Connector\ncd connectors/postgres\nuv run python main.py\n\n# MSSQL Connector\ncd connectors/mssql\nuv run python main.py\n```\n\n## 📖 Documentation\n\nFor complete documentation, visit our [documentation site](https://docs.supermcp.com) or check the `/docs` directory.\n\n- **Getting Started**: Quick setup guide to get SuperMCP running in minutes\n- **Architecture**: Detailed system architecture and component interactions\n- **Connectors Overview**: Learn about MCP connectors and how to build your own\n- **API Reference**: Complete API documentation with examples\n- **Development Guide**: Local development setup and best practices\n- **AI Tools Integration**: Integrate SuperMCP with Cursor, Claude Code, and Windsurf\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 🌟 Why SuperMCP?\n\n- **Production Ready**: Built with enterprise-grade tools like FastAPI, SQLModel, and PostgreSQL\n- **Developer Friendly**: Beautiful dashboard, comprehensive docs, and extensive examples\n- **Extensible**: Easy to add new connectors following provided patterns\n- **Performant**: Async operations, connection pooling, and optimized queries\n- **Secure**: Authentication, encryption, and query safety built-in\n- **Modern Stack**: Latest versions of React, FastAPI, and Python 3.12+\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Community \u0026 Support\n\n- **Issues**: [GitHub Issues](https://github.com/dhanababum/supermcp/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/dhanababum/supermcp/discussions)\n\n## 👨‍💻 Author\n\n**Dhana Babu**\n\n---\n\nReady to get started? Follow our [Quick Start Guide](https://docs.supermcp.com/quickstart) to have SuperMCP running in minutes!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhanababum%2Fsupermcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhanababum%2Fsupermcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhanababum%2Fsupermcp/lists"}