MCP Unified Server

Servidor unificado para protocolo MCP (Model Context Protocol) com painel administrativo web integrado para gerenciamento dinâmico de ferramentas e configurações.

🚀 Como Iniciar

Este projeto roda inteiramente containerizado utilizando o Docker. Para iniciar o servidor e o painel administrativo, certifique-se de que possui o Docker e o Docker Compose instalados na sua máquina.

1. Inicialização Padrão

Para subir o servidor de forma persistente, execute o script auxiliar na raiz do projeto:

./build.sh

Isso compilará a imagem Docker correspondente e iniciará os serviços em segundo plano.

2. Reiniciar o Ambiente do Zero (Opcional)

Se desejar reiniciar o ambiente de desenvolvimento limpando todas as credenciais do Google, logs e o banco de dados de memórias persistidas, execute:

./build.sh --clean

3. Gerenciador Windows (Go)

Para usuários do Windows, há um utilitário interativo CLI desenvolvido em Go dentro da pasta win-manager/. Ele permite controlar o servidor sem precisar do terminal Linux do WSL, além de gerenciar portas, IP exposto e verificar dependências:

• Para rodar o gerenciador:

  cd win-manager
  go run main.go

• Para compilar um executável .exe:

  cd win-manager
  go build -o gerenciador.exe main.go

• Recursos do Gerenciador:

  • Iniciar e Parar o servidor MCP no Docker do Windows.

  • Exposição Dinâmica: Configurar IP de Bind (ex: 127.0.0.1 ou 0.0.0.0) e a Porta do painel.

  • Instalação de Dependências: Verifica se o Docker Desktop está instalado e rodando, e auxilia no download do instalador oficial do Docker para Windows se necessário.

Related MCP server: Promethean OS MCP

🖥️ Painel Administrativo Web

Após iniciar o container, o painel de controle administrativo estará disponível no seu navegador em: 👉 http://localhost:8000

Através da interface do painel web, você poderá realizar todas as seguintes operações de forma gráfica:

1. Alterar o Endpoint do Servidor: Modifique o endereço do webhook WebSocket de conexão a qualquer momento.

2. Habilitar/Desabilitar Ferramentas: Ative ou desative ferramentas de forma individual conforme a sua necessidade.

3. Instruções Personalizadas: Configure as instruções (docstrings) que o modelo de IA recebe para guiar o uso de cada ferramenta.

4. Atualizações Automáticas (Auto-Update): O painel detecta automaticamente se há novas versões de módulos específicos no repositório do GitHub e permite atualizá-los individualmente com apenas um clique.

📂 Configurando a Pasta Compartilhada (Filesystem)

Para garantir o isolamento e a segurança do seu computador, o servidor de arquivos do container possui acesso apenas e estritamente ao diretório /shared_folder.

Como vincular uma pasta física da sua máquina:

1. Acesse o Painel Administrativo (http://localhost:8000).

2. Localize a ferramenta Sistema de Arquivos (filesystem) e clique em Configurar.

3. No campo Caminho da Pasta no Windows/Host, informe o caminho físico do seu computador (exemplo no Windows: C:\Users\seu_usuario\documents\minha_pasta).

4. Clique em Salvar no modal, vá até a aba de Configurações Globais (ou conta) e clique em Salvar & Reiniciar.

5. O painel converterá o caminho automaticamente e reiniciará o container montando a sua pasta física em /shared_folder de forma transparente.

📧 Integração Google Workspace (GSuite)

O painel administrativo possui suporte nativo ao fluxo de autenticação do Google OAuth2.

Como Autenticar:

1. No painel, clique na aba Configurações do Google Workspace.

2. Digite o e-mail da sua conta Google e clique em Gerar Link de Autenticação.

3. Siga as instruções na tela do Google para autorizar o acesso e copie o código gerado.

4. Cole o código no campo indicado e confirme. A conta será ativada instantaneamente para leitura/busca de e-mails do Gmail, gerenciamento do Google Agenda (Calendar) e Google Drive.

🛠️ Comandos Básicos (Docker Compose Manual)

Se preferir gerenciar o container manualmente sem usar o ./build.sh:

• Subir serviços: docker compose up -d

• Parar serviços: docker compose down

• Visualizar logs: docker compose logs -f