WhatsApp MCP Server
一个 WhatsApp MCP (消息控制协议) 服务器的实现
krusleung
README
WhatsApp MCP 服务器
一个用于 WhatsApp 集成的多渠道平台服务器,允许您通过 REST API 以编程方式发送和接收消息。
功能
- 通过二维码认证进行 WhatsApp 连接管理
- 发送和接收文本消息
- 发送媒体消息(图像、文档等)
- 联系人管理
- 聊天记录
- 会话持久化
- 用于与其他应用程序集成的 REST API
前提条件
- Node.js (v14 或更高版本)
- MongoDB (可选,但推荐用于消息存储)
- 一个 WhatsApp 帐户
安装
- 克隆存储库:
git clone https://github.com/krusleung/whatsapp-mcp-server.git
cd whatsapp-mcp-server
- 安装依赖项:
npm install
- 从示例创建
.env
文件:
cp .env.example .env
- 编辑
.env
文件以进行配置
运行服务器
启动开发服务器:
npm run dev
用于生产环境:
npm start
API 文档
身份验证
服务器使用 WhatsApp Web 的二维码进行身份验证。 首次启动服务器时,二维码将显示在控制台中。 使用您的 WhatsApp 移动应用程序扫描此二维码:
- 在您的手机上打开 WhatsApp
- 点击菜单或设置,然后选择 WhatsApp Web
- 扫描终端中显示的二维码
API 端点
身份验证路由
GET /api/auth/status
- 检查身份验证状态POST /api/auth/logout
- 从 WhatsApp 登出POST /api/auth/restart
- 重新启动 WhatsApp 客户端
消息路由
POST /api/messages/send
- 发送文本消息POST /api/messages/send-media
- 发送媒体消息GET /api/messages/history/:contact
- 获取与联系人的聊天记录
联系人路由
GET /api/contacts
- 获取所有联系人GET /api/contacts/:id
- 按 ID 获取联系人GET /api/contacts/chats
- 获取所有聊天
使用示例
发送消息
curl -X POST http://localhost:3000/api/messages/send \
-H "Content-Type: application/json" \
-d '{"to": "1234567890", "message": "Hello from WhatsApp MCP Server!"}'
获取联系人
curl -X GET http://localhost:3000/api/contacts
许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。
鸣谢
- whatsapp-web.js - WhatsApp Web API
- Express - Web 框架
- Mongoose - MongoDB ODM
推荐服务器
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Apple MCP Server
通过 MCP 协议与 Apple 应用(如“信息”、“备忘录”和“通讯录”)进行交互,从而使用自然语言发送消息、搜索和打开应用内容。
MCP Server Trello
通过 Trello API 促进与 Trello 看板的交互,提供速率限制、类型安全、输入验证和错误处理等功能,以实现对卡片、列表和看板活动的无缝管理。
@kazuph/mcp-gmail-gas
用于 Gmail 集成的模型上下文协议 (Model Context Protocol, MCP) 服务器。它允许 Claude Desktop(或任何 MCP 客户端)通过 Google Apps Script 与您的 Gmail 帐户进行交互。

Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。
Composio MCP Server
一个服务器实现,提供与 MCP 兼容的 Composio 应用(如 Gmail 和 Linear)的访问,允许通过结构化的接口与语言模型进行交互。

Folderr
一个模型上下文协议 (MCP) 服务器,它提供与 Folderr API 交互的工具,专门用于管理 Folderr 助手并与之通信。

mcp-google
一个专门的模型上下文协议(MCP)服务器,它将 Google 服务(Gmail、日历等)集成到您的 AI 工作流程中。该服务器通过 MCP 实现对 Google 服务的无缝访问,从而允许 AI 代理与 Gmail、Google 日历和其他 Google 服务进行交互。
MCP-JIRA-Python Server
一个基于 Python 的服务器,允许与 JIRA 无缝集成,通过自定义 API 管理和交互项目。
Email sending MCP 💌
使用此电子邮件发送 MCP 服务器,直接从 Cursor 发送电子邮件