mcp-switchboard

Intelligent MCP server orchestrator that automates configuration, orchestration, and lifecycle management of other MCP servers for AI agents.

Overview

mcp-switchboard eliminates the manual overhead of configuring MCP servers for AI agents by:

• Analyzing task context to determine required MCP servers

• Selecting appropriate servers based on intelligent matching

• Configuring servers with correct credentials and settings

• Validating server health and tool availability

• Learning from historical patterns to improve recommendations

Time Savings: Reduces MCP setup from 5-15 minutes to <30 seconds per task

Quick Start

Installation

Using uv (Recommended - Fast & Modern):

# Install from PyPI
uv pip install mcp-switchboard

# Or run directly without installation
uvx mcp-switchboard --analyze "Deploy ECS to prod"
uvx mcp-switchboard-server  # Run MCP server

From source:

# Clone repository
git clone https://github.com/aslanpour/mcp-switchboard
cd mcp-switchboard

# Install with uv
uv pip install -e .

# Or with pip
pip install -e .

Basic Usage

from mcp_switchboard.analyzer.analyzer import TaskAnalyzer
from mcp_switchboard.selector.selector import ServerSelector
from mcp_switchboard.config.registry import ServerRegistry

# Analyze task
analyzer = TaskAnalyzer()
analysis = analyzer.analyze("Deploy ECS to prod Tokyo using DEVOPS-123")

# Select servers
registry = ServerRegistry()
selector = ServerSelector(registry)
selection = selector.select(analysis)

# Results
print(f"Selected: {[s.server_name for s in selection.selected_servers]}")
# Output: ['atlassian-mcp', 'aws-api-mcp']

Features

• ✅ Intelligent task analysis with confidence scoring

• ✅ Capability-based server selection

• ✅ AWS SSO and OAuth credential management

• ✅ Multi-agent configuration support

• ✅ Snapshot and rollback capabilities

• ✅ State tracking and historical learning

• ✅ Structured logging and metrics

Requirements

• Python 3.9+

• AWS CLI (for AWS SSO)

• Node.js/npm (for npm-based MCP servers)

Development

# Run tests
pytest tests/

# Format code
black src/ tests/

# Type check
mypy src/

Status

Current Version: v1.0.0 - Production Ready 🎉

Functional Completion: 100%

What Works:

• ✅ Task analysis (keyword + LLM)

• ✅ Server selection with confidence scoring

• ✅ Historical pattern learning (NEW in v1.0.0)

• ✅ Credential management (AWS SSO, OAuth, tokens)

• ✅ Configuration writing with snapshots

• ✅ Configuration rollback

• ✅ Real-time health monitoring (NEW in v1.0.0)

• ✅ State tracking and history

• ✅ MCP server with 6 tools

• ✅ Multi-transport (STDIO/SSE/HTTP)

• ✅ Server subprocess management

• ✅ Full orchestration workflow

MCP Tools Available:

1. setup_mcp_servers - Complete orchestration with real-time health monitoring

2. analyze_task - Extract task requirements

3. select_servers - Recommend MCP servers (with historical learning)

4. manage_servers - Subprocess management

5. rollback_configuration - Restore previous config

6. list_snapshots - View available snapshots

Advanced Features:

• Real-time server startup validation

• Historical pattern learning for better recommendations

• Confidence boosting based on past success

• Exponential backoff retry logic

• Detailed health metrics (startup time, tools available)

Tests: 85/85 passing (100%)

Performance:

• Task analysis: <2ms

• Server selection: <1ms

• Total orchestration: 2-3 seconds

• Health validation: <1 second per server

See CHANGELOG.md for version history.

License

[To be determined]