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:

Option 1: Using the deployed server on Render (Recommended)

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