MCP WebSocket Server

MCP WebSocket服务器

在WebSocket上运行的模型上下文协议（MCP）服务器。专为邮件操作和通信而设计。

特性

• 🔌 WebSocket连接
• 📧 邮件检索和搜索
• 📊 邮件统计
• 🚀 可以托管在Render.com上
• 🏥 健康检查端点

安装

npm install
npm run build
npm start

用法

Claude桌面配置

有两种方法可以配置Claude Desktop以使用此服务器：

选项1：在Render上使用已部署的服务器（推荐）

添加到您的 %APPDATA%\Claude\claude_desktop_config.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"
      ]
    }
  }
}

选项2：使用本地服务器

首先启动本地服务器：

npm start

然后配置Claude Desktop：

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

API终点

• / -Web界面
• /health -健康检查端点
• /mcp -MCP的WebSocket端点

可用工具

• test_baglanti -测试连接
• mail_getir -获取指定电子邮件地址的最新邮件
• mail_ara -在邮件内容中搜索
• mail_istatistik -显示邮件统计信息

部署

在Render.com上部署：

1. 推送到GitHub
2. 在Render.com上创建新的Web服务
3. 连接您的GitHub存储库
4. 配置生成设置：

- 生成命令: npm install && npm run build - 启动命令: npm start - 健康检查路径: /health

环境

• 需要Node.js 16.0.0或更高版本
• 自动使用 PORT 环境变量

测试

测试您的部署：

• 主页： https://mcp-websocket-server.onrender.com/
• 健康检查： https://mcp-websocket-server.onrender.com/health
• Websocket： wss://mcp-websocket-server.onrender.com/mcp

直接测试WebSocket连接：

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

故障排除

如果您在Claude Desktop日志中看到“意外令牌”等错误：

1. 确保您使用的是stdio-bridge.js文件
2. 确保WebSocket URL正确
3. 检查服务器是否正在运行且可访问

许可证

麻省理工学院