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.

- 🔍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

# Install globally npm install -g @mcp/aggregator # Run setup mcp-aggregator setup # Start the aggregator mcp-aggregator start

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

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

The aggregator uses a flexible configuration system:
- Environment Variables- Override any setting
- Config File-~/.mcp/aggregator/config.json
- Auto-Discovery- Finds servers automatically
- Defaults- Sensible defaults for everything

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

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

Add to your Claude Desktop configuration:

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

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

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

# 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

Contributions are welcome! Please read ourContributing Guidefor details on our code of conduct and the process for submitting pull requests.

For security issues, please emaildaniel@willitzer.cominstead of using the issue tracker.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB