MCP WebSocket Server

by henrydyson

Not rated
GitHub

About

A WebSocket server for handling mail operations.

Details

Author
henrydyson
Categories
Communication, Automation

Setup

Install MCP WebSocket Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/henrydyson/mcp-websocket-server

Follow the installation instructions in the repository README, then restart your MCP client.

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

- πŸ”Œ WebSocket connection
- πŸ“§ Mail retrieval and search
- πŸ“Š Mail statistics
- πŸš€ Can be hosted on Render.com
- πŸ₯ Health check endpoint

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.jsonfile:

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

- /- Web interface
- /health- Health check endpoint
- /mcp- WebSocket endpoint for MCP

- 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
- Push to GitHub
- Create a new Web Service on Render.com
- Connect your GitHub repository
- Configure build settings:

- Build command:npm install && npm run build
- Start command:npm start
- Health check path:/health

- Node.js 16.0.0 or higher required
- Automatically usesPORTenvironment variable

- 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

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

If you see errors like "Unexpected token" in Claude Desktop logs:
- Make sure you're using the stdio-bridge.js file
- Ensure the WebSocket URL is correct
- Check that the server is running and accessible

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Turn AI tools into your email marketing assistant.

Turn an AI tool into your smart email engine

Connect your AI assistant to Onboard to monitor live onboarding projects, surface blocked tasks and risks, draft customer emails, and take action on tasks with role-based access and preview-first safety.

Send and receive emails, SMS, and voice calls via Pingram.

Send emails directly from your editor using the Resend API.

Sendmux is an email inbox API and email API for AI agents.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.