# 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
## Installation
```bash
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:
```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"
]
}
}
}
```
#### Option 2: Using a local server
First start your local server:
```bash
npm start
```
Then configure Claude Desktop:
```json
{
"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:
```bash
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
