MCP Aggregator

A universal aggregator for combining multiple MCP (Model Context Protocol) servers into a single endpoint for AI assistants to access various tools and capabilities.

Features

• 🔍 Auto-Discovery - Automatically finds installed MCP servers
• 🚀 Zero Configuration - Works out of the box with sensible defaults
• 🔧 Highly Configurable - Customize every aspect when needed
• 🏗️ Multi-Server Support - Aggregate multiple MCP servers
• 🔄 Hot Reload - Add/remove servers without restart
• 📊 Health Monitoring - Automatic health checks and recovery
• 🔒 Secure by Default - No hardcoded secrets or paths

Available MCP Servers

The aggregator can work with any MCP-compliant server. Common servers include:

• filesystem - File operations (read, write, list)
• shell - Command execution
• git - Version control operations
• browser - Web automation
• slack - Slack integration
• github - GitHub operations
• 1password - Secret management

Documentation

• Getting Started
• Configuration Guide
• Server Integration
• API Reference
• Deployment Guide
• Troubleshooting

Development

# Clone repository
git clone https://github.com/dwillitzer/mcp-aggregator.git
cd mcp-aggregator

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

Security

For security issues, please email daniel@willitzer.com instead of using the issue tracker.

Quick Start

# Install globally
npm install -g @mcp/aggregator

# Run setup
mcp-aggregator setup

# Start the aggregator
mcp-aggregator start

Installation

From npm

npm install -g @mcp/aggregator

From Source

git clone https://github.com/dwillitzer/mcp-aggregator.git
cd mcp-aggregator
npm install
npm run build
npm link

Using Docker

docker pull ghcr.io/dwillitzer/mcp-aggregator:latest
docker run -d -p 3000:3000 ghcr.io/dwillitzer/mcp-aggregator:latest

Configuration

The aggregator uses a flexible configuration system:

1. Environment Variables - Override any setting
2. Config File - ~/.mcp/aggregator/config.json
3. Auto-Discovery - Finds servers automatically
4. Defaults - Sensible defaults for everything

Basic Configuration

{
  "aggregator": {
    "port": 3000,
    "host": "localhost"
  },
  "servers": {
    "filesystem": {
      "enabled": true,
      "command": "mcp-server-filesystem"
    },
    "shell": {
      "enabled": true,
      "command": "mcp-server-shell"
    }
  }
}

Usage with Claude

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "aggregator": {
      "command": "mcp-aggregator",
      "args": ["start", "--stdio"]
    }
  }
}

Claude Guard

The aggregator integrates seamlessly with Claude Guard:

# Auto-detected if installed
claude-guard --mcp-status

# Or specify custom path
claude-guard --mcp-aggregator /path/to/aggregator

License

This software is proprietary to Daniel Willitzer with specific usage permissions.

Key points:

• ✅ Free to use, modify, and distribute
• ✅ Commercial use allowed
• ⚠️ Derivative works MUST declare: "This is a derivative work based on MCP Aggregator by Daniel Willitzer"
• ⚠️ Must indicate modifications made

See LICENSE for full details.