MCP Aggregator

Un agregador universal que combina múltiples servidores MCP en un único punto final.

Documentación

MCP Aggregator

Un agregador universal para combinar múltiples servidores MCP (Model Context Protocol) en un único endpoint para que los asistentes de IA accedan a diversas herramientas y capacidades.

Características

🔍 Auto-descubrimiento - Encuentra automáticamente los servidores MCP instalados
🚀 Configuración cero - Funciona de inmediato con valores predeterminados sensatos
🔧 Altamente configurable - Personaliza cada aspecto cuando sea necesario
🏗️ Soporte multi-servidor - Agrega múltiples servidores MCP
🔄 Recarga en caliente - Añade/elimina servidores sin reiniciar
📊 Monitoreo de salud - Comprobaciones de salud automáticas y recuperación
🔒 Seguro por defecto - Sin secretos ni rutas codificadas

Inicio rápido

# Install globally
npm install -g @mcp/aggregator

# Run setup
mcp-aggregator setup

# Start the aggregator
mcp-aggregator start

Instalación

Desde npm

npm install -g @mcp/aggregator

Desde el código fuente

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

Usando Docker

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

Configuración

El agregador utiliza un sistema de configuración flexible:

Variables de entorno - Sobrescribe cualquier ajuste
Archivo de configuración - ~/.mcp/aggregator/config.json
Auto-descubrimiento - Encuentra servidores automáticamente
Valores predeterminados - Valores predeterminados sensatos para todo

Configuración básica

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

Servidores MCP disponibles

El agregador puede funcionar con cualquier servidor compatible con MCP. Los servidores comunes incluyen:

filesystem - Operaciones de archivos (leer, escribir, listar)
shell - Ejecución de comandos
git - Operaciones de control de versiones
browser - Automatización web
slack - Integración con Slack
github - Operaciones de GitHub
1password - Gestión de secretos

Uso con Claude

Claude Desktop

Añade a tu configuración de Claude Desktop:

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

Claude Guard

El agregador se integra perfectamente con Claude Guard:

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

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

Documentación

Desarrollo

# 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

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee nuestra Guía de contribución para conocer los detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

Licencia

Este software es propiedad de Daniel Willitzer con permisos de uso específicos.

Puntos clave:

✅ Libre de usar, modificar y distribuir
✅ Uso comercial permitido
⚠️ Las obras derivadas DEBEN declarar: "Esta es una obra derivada basada en MCP Aggregator de Daniel Willitzer"
⚠️ Debe indicar las modificaciones realizadas

Consulta LICENCIA para obtener todos los detalles.

Seguridad

Para problemas de seguridad, envía un correo electrónico a daniel@willitzer.com en lugar de usar el rastreador de problemas.