ARCHITECTURE.md•10.8 kB
# SuperMCP Architecture
## System Overview
```
┌─────────────────────────────────────────────────────────────────┐
│ SuperMCP │
│ (Orchestration Layer) │
└─────────────────────┬───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Available MCPs │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │
│ │ ShellMCP │ │CodeAnalysis │ │FileSystem │ │ EchoMCP │ │
│ │ │ │ MCP │ │ MCP │ │ │ │
│ │ • Terminal │ │ • Code │ │ • File │ │ • Test │ │
│ │ Commands │ │ Analysis │ │ Ops │ │ • Echo │ │
│ │ • Package │ │ • File │ │ • Directory │ │ • Valid │ │
│ │ Install │ │ Reading │ │ Mgmt │ │ • Temp │ │
│ │ • Security │ │ • Structure │ │ • Cross- │ │ │ │
│ │ Controls │ │ Analysis │ │ Platform │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
## MCP Discovery Process
```
┌─────────────────────────────────────────────────────────────────┐
│ SuperMCP Discovery │
│ │
│ 1. Scan available_mcps/ directory │
│ └── Recursively find all server.py files │
│ │
│ 2. Register each MCP server │
│ └── Name: Parent directory name │
│ └── Path: Full path to server.py │
│ └── Command: Python executable + args │
│ │
│ 3. Maintain registry of available servers │
│ └── Dynamic discovery and management │
└─────────────────────────────────────────────────────────────────┘
```
## AI MCP Generation Workflow
```
┌─────────────────────────────────────────────────────────────────┐
│ AI MCP Generation Process │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ User │───▶│ AI │───▶│ SuperMCP │ │
│ │ Request │ │ Analysis │ │Orchestration│ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │CodeAnalysis │ │FileSystem │ │ ShellMCP │ │
│ │ MCP │ │ MCP │ │ │ │
│ │ • Analyze │ │ • Create │ │ • Install │ │
│ │ Templates │ │ Directories│ │ Packages │ │
│ │ • Study │ │ • Write │ │ • Test │ │
│ │ Patterns │ │ Files │ │ Servers │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ EchoMCP │ │ Generated │ │ SuperMCP │ │
│ │ │ │ MCP │ │ Discovery │ │
│ │ • Validate │ │ Server │ │ │ │
│ │ • Test │ │ │ │ • Auto- │ │
│ │ • Template │ │ • Ready to │ │ discover │ │
│ │ Source │ │ Use │ │ • Register │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
## Directory Structure
```
SuperMCP/
├── SuperMCP.py # Main orchestration server
├── TestClient.py # Test client
├── pyproject.toml # Dependencies
├── README.md # Documentation
└── available_mcps/ # MCP server directory
├── ShellMCP/ # Terminal operations
│ ├── server.py
│ └── requirements.txt
├── CodeAnalysisMCP/ # Code analysis
│ ├── server.py
│ └── requirements.txt
├── FileSystemMCP/ # File operations
│ ├── server.py
│ └── file-system-mcp-server/
│ ├── fs_server.py
│ └── requirements.txt
└── EchoMCP/ # Testing & validation
├── server.py
└── requirements.txt
```
## Key Features
### 🔍 **Dynamic Discovery**
- Automatically finds `server.py` files in subdirectories
- Recursive scanning of `available_mcps/` folder
- Hot reloading without restart
### 🛠️ **MCP Management**
- `list_servers` - View all detected MCP servers
- `inspect_server` - Get detailed server capabilities
- `call_server_tool` - Execute tools from any server
- `reload_servers` - Refresh server registry
### 🚀 **AI MCP Generation**
- Complete toolkit for generating new MCP servers
- Template-based generation using EchoMCP
- Cross-platform file operations
- Automated testing and validation
### 🔒 **Local Operation**
- No internet required
- Works on Windows, macOS, Linux
- Secure, sandboxed execution
- Privacy-focused design
## Integration with J.A.R.V.I.S.
```
┌─────────────────────────────────────────────────────────────────┐
│ J.A.R.V.I.S. │
│ (AI Assistant System) │
└─────────────────────┬───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ SuperMCP │
│ (MCP Orchestration) │
└─────────────────────┬───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ MCP Ecosystem │
│ │
│ • ShellMCP - Terminal operations │
│ • CodeAnalysisMCP - Code analysis │
│ • FileSystemMCP - File operations │
│ • EchoMCP - Testing & validation │
│ • [Generated] - AI-created MCP servers │
└─────────────────────────────────────────────────────────────────┘
```
## Benefits
- **🔄 Extensible**: Add new MCP servers without code changes
- **🧠 AI-Ready**: Perfect foundation for AI-driven MCP generation
- **🏠 Local**: No internet dependencies, complete privacy
- **🌍 Cross-Platform**: Works on any operating system
- **⚡ Fast**: Dynamic discovery and hot reloading
- **🔒 Secure**: Sandboxed execution with approval workflows