WhatsApp MCP Server

WhatsApp MCP Server

一个 WhatsApp MCP (消息控制协议) 服务器的实现

krusleung

通信
访问服务器

README

WhatsApp MCP 服务器

一个用于 WhatsApp 集成的多渠道平台服务器,允许您通过 REST API 以编程方式发送和接收消息。

功能

  • 通过二维码认证进行 WhatsApp 连接管理
  • 发送和接收文本消息
  • 发送媒体消息(图像、文档等)
  • 联系人管理
  • 聊天记录
  • 会话持久化
  • 用于与其他应用程序集成的 REST API

前提条件

  • Node.js (v14 或更高版本)
  • MongoDB (可选,但推荐用于消息存储)
  • 一个 WhatsApp 帐户

安装

  1. 克隆存储库:
git clone https://github.com/krusleung/whatsapp-mcp-server.git
cd whatsapp-mcp-server
  1. 安装依赖项:
npm install
  1. 从示例创建 .env 文件:
cp .env.example .env
  1. 编辑 .env 文件以进行配置

运行服务器

启动开发服务器:

npm run dev

用于生产环境:

npm start

API 文档

身份验证

服务器使用 WhatsApp Web 的二维码进行身份验证。 首次启动服务器时,二维码将显示在控制台中。 使用您的 WhatsApp 移动应用程序扫描此二维码:

  1. 在您的手机上打开 WhatsApp
  2. 点击菜单或设置,然后选择 WhatsApp Web
  3. 扫描终端中显示的二维码

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 文件。

鸣谢

推荐服务器

graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Apple MCP Server

Apple MCP Server

通过 MCP 协议与 Apple 应用(如“信息”、“备忘录”和“通讯录”)进行交互,从而使用自然语言发送消息、搜索和打开应用内容。

精选
本地
TypeScript
MCP Server Trello

MCP Server Trello

通过 Trello API 促进与 Trello 看板的交互,提供速率限制、类型安全、输入验证和错误处理等功能,以实现对卡片、列表和看板活动的无缝管理。

精选
TypeScript
@kazuph/mcp-gmail-gas

@kazuph/mcp-gmail-gas

用于 Gmail 集成的模型上下文协议 (Model Context Protocol, MCP) 服务器。它允许 Claude Desktop(或任何 MCP 客户端)通过 Google Apps Script 与您的 Gmail 帐户进行交互。

精选
JavaScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Composio MCP Server

Composio MCP Server

一个服务器实现,提供与 MCP 兼容的 Composio 应用(如 Gmail 和 Linear)的访问,允许通过结构化的接口与语言模型进行交互。

官方
TypeScript
Folderr

Folderr

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

官方
JavaScript
mcp-google

mcp-google

一个专门的模型上下文协议(MCP)服务器,它将 Google 服务(Gmail、日历等)集成到您的 AI 工作流程中。该服务器通过 MCP 实现对 Google 服务的无缝访问,从而允许 AI 代理与 Gmail、Google 日历和其他 Google 服务进行交互。

本地
TypeScript
MCP-JIRA-Python Server

MCP-JIRA-Python Server

一个基于 Python 的服务器,允许与 JIRA 无缝集成,通过自定义 API 管理和交互项目。

本地
Python
Email sending MCP 💌

Email sending MCP 💌

使用此电子邮件发送 MCP 服务器,直接从 Cursor 发送电子邮件

本地
TypeScript