AI导哈

邮件通信WebSocket服务器

一个基于WebSocket的模型上下文协议(MCP)服务器，专为邮件操作和通信设计，提供邮件检索、搜索和统计功能。

  • by henrydyson
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 henrydyson/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. 检查服务器是否正在运行且可访问

许可证

麻省理工学院

相关 MCP