Skip to main content
Glama
MCP WebSocket Server

MCP WebSocket Server

by henrydyson

MCP WebSocket Server

A Model Context Protocol (MCP) server that operates over WebSocket. Designed for mail operations and communication.

Features

  • πŸ”Œ WebSocket connection

  • πŸ“§ Mail retrieval and search

  • πŸ“Š Mail statistics

  • πŸš€ Can be hosted on Render.com

  • πŸ₯ Health check endpoint

Related MCP server: mcp-email

Installation

npm install
npm run build
npm start

Usage

Claude Desktop Configuration

There are two ways to configure Claude Desktop to use this server:

Add to your %APPDATA%\Claude\claude_desktop_config.json file:

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

Option 2: Using a local server

First start your local server:

npm start

Then configure Claude Desktop:

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

API Endpoints

  • / - Web interface

  • /health - Health check endpoint

  • /mcp - WebSocket endpoint for MCP

Available Tools

  • test_baglanti - Test the connection

  • mail_getir - Get the latest mail for a specified email address

  • mail_ara - Search within mail content

  • mail_istatistik - Show mail statistics

Deployment

Deploy on Render.com:

  1. Push to GitHub

  2. Create a new Web Service on Render.com

  3. Connect your GitHub repository

  4. Configure build settings:

    • Build command: npm install && npm run build

    • Start command: npm start

    • Health check path: /health

Environment

  • Node.js 16.0.0 or higher required

  • Automatically uses PORT environment variable

Testing

Test your deployment:

  • Main page: https://mcp-websocket-server.onrender.com/

  • Health check: https://mcp-websocket-server.onrender.com/health

  • WebSocket: wss://mcp-websocket-server.onrender.com/mcp

Test the WebSocket connection directly:

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

Troubleshooting

If you see errors like "Unexpected token" in Claude Desktop logs:

  1. Make sure you're using the stdio-bridge.js file

  2. Ensure the WebSocket URL is correct

  3. Check that the server is running and accessible

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Cross-platform MCP server and CLI for email operations, including send, read, search, and contact management, compatible with Gmail, Outlook, Yahoo, and any IMAP/SMTP providers.
      29 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables email management (send, read, search, delete, etc.) via IMAP/SMTP, compatible with Gmail, Outlook, Yahoo, iCloud, and other standard mail servers.
      11
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A minimal MCP server for reading and sending emails via IMAP/SMTP, supporting multiple accounts in a single instance with zero external dependencies.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A minimal MCP server for reading, searching, managing, and sending email over IMAP and SMTP.
      MIT