MCP WebSocket Server

Servidor WebSocket MCP

Um servidor Model Context Protocol (MCP) que opera via WebSocket. Projetado para operações de e-mail e comunicação.

Recursos

• 🔌 Conexão WebSocket
• 📧 Recuperação e busca de e-mails
• 📊 Estatísticas de e-mail
• 🚀 Pode ser hospedado no Render.com
• 🏥 Endpoint de verificação de saúde

Instalação

npm install
npm run build
npm start

Uso

Configuração do Claude Desktop

Existem duas maneiras de configurar o Claude Desktop para usar este servidor:

Opção 1: Usando o servidor implantado no Render (Recomendado)

Adicione ao seu arquivo %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "mail-mcp-server": {
      "command": "node",
      "args": [
        "C:\\Users\\Thinkpad\\Desktop\\mcp-websocket-server\\stdio-bridge.js",
        "wss://mcp-websocket-server.onrender.com/mcp"
      ]
    }
  }
}

Opção 2: Usando um servidor local

Primeiro, inicie seu servidor local:

npm start

Em seguida, configure o Claude Desktop:

{
  "mcpServers": {
    "mail-mcp-server": {
      "command": "node",
      "args": [
        "C:\\Users\\Thinkpad\\Desktop\\mcp-websocket-server\\stdio-bridge.js",
        "ws://localhost:3000/mcp"
      ]
    }
  }
}

Endpoints da API

• / - Interface web
• /health - Endpoint de verificação de saúde
• /mcp - Endpoint WebSocket para MCP

Ferramentas Disponíveis

• test_baglanti - Testar a conexão
• mail_getir - Obter o e-mail mais recente para um endereço de e-mail especificado
• mail_ara - Pesquisar dentro do conteúdo do e-mail
• mail_istatistik - Mostrar estatísticas de e-mail

Implantação

Implantar no Render.com:

1. Envie para o GitHub
2. Crie um novo Web Service no Render.com
3. Conecte seu repositório do GitHub
4. Configure as configurações de build:
   • Comando de build: npm install && npm run build
   • Comando de início: npm start
   • Caminho de verificação de saúde: /health

Ambiente

• Node.js 16.0.0 ou superior necessário
• Usa automaticamente a variável de ambiente PORT

Testes

Teste sua implantação:

• Página principal: https://mcp-websocket-server.onrender.com/
• Verificação de saúde: https://mcp-websocket-server.onrender.com/health
• WebSocket: wss://mcp-websocket-server.onrender.com/mcp

Teste a conexão WebSocket diretamente:

npm install -g wscat
wscat -c wss://mcp-websocket-server.onrender.com/mcp

Solução de Problemas

Se você vir erros como "Unexpected token" nos logs do Claude Desktop:

1. Certifique-se de estar usando o arquivo stdio-bridge.js
2. Verifique se a URL do WebSocket está correta
3. Confirme que o servidor está em execução e acessível

Licença

MIT