MCP Aggregator

Um agregador universal que combina múltiplos servidores MCP em um único endpoint.

Documentação

MCP Aggregator

Um agregador universal para combinar múltiplos servidores MCP (Model Context Protocol) em um único endpoint para assistentes de IA acessarem diversas ferramentas e capacidades.

Recursos

🔍 Descoberta Automática - Encontra automaticamente servidores MCP instalados
🚀 Zero Configuração - Funciona imediatamente com padrões sensatos
🔧 Altamente Configurável - Personalize cada aspecto quando necessário
🏗️ Suporte Multi-Servidor - Agrega múltiplos servidores MCP
🔄 Recarga Dinâmica - Adicione/remova servidores sem reiniciar
📊 Monitoramento de Saúde - Verificações automáticas de saúde e recuperação
🔒 Seguro por Padrão - Sem segredos ou caminhos codificados

Início Rápido

# Install globally
npm install -g @mcp/aggregator

# Run setup
mcp-aggregator setup

# Start the aggregator
mcp-aggregator start

Instalação

Via npm

npm install -g @mcp/aggregator

A partir do Código-Fonte

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

Configuração

O agregador utiliza um sistema de configuração flexível:

Variáveis de Ambiente - Sobrescreva qualquer configuração
Arquivo de Configuração - ~/.mcp/aggregator/config.json
Descoberta Automática - Encontra servidores automaticamente
Padrões - Padrões sensatos para tudo

Configuração Básica

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

Servidores MCP Disponíveis

O agregador pode trabalhar com qualquer servidor compatível com MCP. Servidores comuns incluem:

filesystem - Operações de arquivo (ler, escrever, listar)
shell - Execução de comandos
git - Operações de controle de versão
browser - Automação web
slack - Integração com Slack
github - Operações no GitHub
1password - Gerenciamento de segredos

Uso com Claude

Claude Desktop

Adicione à sua configuração do Claude Desktop:

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

Claude Guard

O agregador integra-se perfeitamente com o Claude Guard:

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

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

Documentação

Desenvolvimento

# 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

Contribuindo

Contribuições são bem-vindas! Por favor, leia nosso Guia de Contribuição para detalhes sobre nosso código de conduta e o processo para envio de pull requests.

Licença

Este software é proprietário de Daniel Willitzer com permissões de uso específicas.

Pontos-chave:

✅ Livre para usar, modificar e distribuir
✅ Uso comercial permitido
⚠️ Trabalhos derivados DEVEM declarar: "Este é um trabalho derivado baseado no MCP Aggregator por Daniel Willitzer"
⚠️ Deve indicar as modificações realizadas

Consulte LICENÇA para detalhes completos.

Segurança

Para questões de segurança, envie um e-mail para daniel@willitzer.com em vez de usar o rastreador de problemas.