StartMCP

Neverdecel/StartMCP

3.2

If you are the rightful owner of StartMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

startmcp is a unified MCP gateway server that aggregates multiple backend providers into a single connection point for AI assistants.

startmcp

Unified MCP gateway server that aggregates multiple backend providers into a single connection point for AI assistants.

MCP Protocol Python 3.12+ License: MIT

🎯 What is startmcp?

startmcp is an MCP gateway server that connects AI assistants (like Claude) to multiple data sources through a single, unified interface.

The Problem

AI assistants need to connect to multiple MCP servers (Atlassian, GitHub, databases, etc.), requiring separate configurations for each provider.

The Solution

startmcp acts as a gateway that aggregates all your providers into one MCP server:

Before (Multiple Connections):          After (Single Gateway):
┌─────────────┐                         ┌─────────────┐
│ AI Assistant│                         │ AI Assistant│
└──────┬──────┘                         └──────┬──────┘
       │                                       │
   ┌───┴───┬───────┬───────┐                 │
   │       │       │       │                  │
┌──▼─┐  ┌─▼──┐  ┌─▼──┐  ┌─▼──┐         ┌───▼────────┐
│Atl.│  │GH  │  │ DB │  │ etc│         │  startmcp  │
│MCP │  │MCP │  │MCP │  │MCP │         │   Gateway  │
└────┘  └────┘  └────┘  └────┘         └────┬───────┘
                                             │
                                   ┌─────────┼────────┬─────┐
                                   │         │        │     │
                                ┌──▼─┐   ┌──▼──┐  ┌──▼─┐ ┌─▼──┐
                                │Atl.│   │ GH  │  │ DB │ │etc │
                                │MCP │   │ MCP │  │MCP │ │MCP │
                                └────┘   └─────┘  └────┘ └────┘

✨ Key Features

  • 🎯 Single MCP Server - One connection for all your providers
  • 🔀 Smart Routing - Tools route to the correct backend automatically
  • 🏷️ Hybrid Namespacing - Natural names when unique, prefixed only on conflicts
  • 🔐 OAuth 2.1 Support - Browser-based authentication
  • 🧙 Interactive Wizard - Beautiful CLI setup experience
  • 📦 Plugin Architecture - Easy to add custom providers
  • ⚡ Near-Native Performance - Minimal routing overhead (~5ms)

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/yourusername/startmcp.git
cd startmcp

# Install with pip
pip install -e .

# Verify installation
mcp --help

Setup

Run the interactive wizard:

mcp init

The wizard will:

  1. Show available providers by category
  2. Guide you through authentication (browser opens for OAuth)
  3. Verify the connection works
  4. Save configuration to config.yaml

Start the Gateway

mcp serve --stdio

The gateway will:

  • Load your config.yaml
  • Connect to all enabled providers
  • Aggregate tools from each provider
  • Start the stdio MCP server
  • Listen for requests from your AI assistant

Connect Your AI Assistant

For Claude Desktop, add to ~/.config/claude/config.json:

{
  "mcpServers": {
    "startmcp": {
      "command": "mcp",
      "args": ["serve", "--stdio"]
    }
  }
}

Restart Claude Desktop, and you'll have access to all your providers' tools!

🏗️ Architecture

startmcp implements a gateway pattern for MCP:

  1. Tool Aggregation - Collects tools from all providers
  2. Conflict Detection - Identifies tool name collisions
  3. Hybrid Namespacing - Keeps natural names when possible:
    • search_issues → Routes to Atlassian (unique name)
    • create_pr → Routes to GitHub (unique name)
    • atlassian:list_projects → Explicit routing (conflict with GitHub)
    • github:list_projects → Explicit routing (conflict with Atlassian)
  4. Smart Routing - Directs each tool call to the correct provider
  5. Helpful Errors - Suggests correct tool names on ambiguity

See for details.

📦 Available Providers

🏢 Enterprise

  • Atlassian Suite - Jira, Confluence, Compass (OAuth via mcp-remote)

🚧 Coming Soon

  • GitHub - Repositories, issues, PRs
  • GitLab - Projects, merge requests
  • PostgreSQL - Database queries
  • MongoDB - Document operations
  • And more...

🛠️ CLI Commands

# Interactive setup wizard
mcp init

# List all available providers
mcp providers list

# List only enabled providers
mcp providers list --enabled

# Start the gateway server
mcp serve --stdio

# Reconfigure setup
mcp init --reconfigure

📁 Project Structure

startmcp/
├── mcp/                        # Core framework
│   ├── protocol.py            # MCP protocol models
│   ├── client.py              # MCP client
│   ├── provider.py            # Provider base class
│   ├── transport/             # SSE and stdio transports
│   ├── server/                # MCP server implementation
│   ├── gateway.py             # Gateway orchestrator
│   ├── aggregator.py          # Tool aggregation
│   ├── router.py              # Tool/resource routing
│   ├── conflict_resolver.py   # Conflict detection
│   ├── registry.py            # Provider discovery
│   └── cli/                   # CLI and wizard
├── provider_mcps/             # Provider implementations
│   ├── enterprise/            # Atlassian, etc.
│   ├── dev_tools/             # GitHub, GitLab, etc.
│   ├── data/                  # Databases
│   ├── cloud/                 # AWS, GCP, Azure
│   └── web/                   # Web services
├── tests/                     # Unit and integration tests
├── docs/                      # Documentation
└── config.yaml               # Your configuration

🔧 Configuration

After running mcp init, your config.yaml will look like:

enabled_providers:
  - atlassian

logging:
  level: INFO
  format: json

timeouts:
  connection: 30
  request: 60

Provider-specific settings can be added:

atlassian:
  default_project: "PROJ"
  cloud_id: "your-cloud-id"

🧑‍💻 Creating Custom Providers

Create a new provider by extending MCPProvider:

# provider_mcps/custom/my_provider/provider.py
from mcp.provider import MCPProvider
from mcp.categories import ProviderCategory

class MyProvider(MCPProvider):
    name = "my_provider"
    display_name = "My Custom Provider"
    category = ProviderCategory.CUSTOM
    transport_type = "sse"  # or "stdio"

    async def create_transport(self):
        # Return configured transport
        pass

See for details.

📚 Documentation

  • Getting Started
  • Architecture
  • Guides
  • Reference
  • Project Background

🤝 Contributing

We welcome contributions! Please see for guidelines.

📝 Changelog

See for version history and release notes.

📄 License

MIT License - see for details.

🙏 Acknowledgments

Made with ❤️ for the AI engineering community