MCP WebSocket Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 startUsage
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 startThen 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 connectionmail_getir- Get the latest mail for a specified email addressmail_ara- Search within mail contentmail_istatistik- Show mail statistics
Deployment
Deploy on Render.com:
Push to GitHub
Create a new Web Service on Render.com
Connect your GitHub repository
Configure build settings:
Build command:
npm install && npm run buildStart command:
npm startHealth check path:
/health
Environment
Node.js 16.0.0 or higher required
Automatically uses
PORTenvironment variable
Testing
Test your deployment:
Main page:
https://mcp-websocket-server.onrender.com/Health check:
https://mcp-websocket-server.onrender.com/healthWebSocket:
wss://mcp-websocket-server.onrender.com/mcp
Test the WebSocket connection directly:
npm install -g wscat
wscat -c wss://mcp-websocket-server.onrender.com/mcpTroubleshooting
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
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for MailTempo's public free temporary email inboxes.
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Hosted MCP server for custom-domain email: send, receive and wait for mail on your domain.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceCross-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 npm1MIT
- AlicenseAqualityDmaintenanceMCP server that enables email management (send, read, search, delete, etc.) via IMAP/SMTP, compatible with Gmail, Outlook, Yahoo, iCloud, and other standard mail servers.11MIT
- FlicenseNot gradedqualityDmaintenanceA minimal MCP server for reading and sending emails via IMAP/SMTP, supporting multiple accounts in a single instance with zero external dependencies.1-
- AlicenseNot gradedqualityDmaintenanceA minimal MCP server for reading, searching, managing, and sending email over IMAP and SMTP.MIT