WhatsApp MCP Server

WhatsApp MCP Server

site icon
2025.03.23 3
TypeScriptWhatsApp 接口消息服务群组管理交流协作
WhatsApp MCP Server 是一个基于 Model Context Protocol (MCP) SDK 实现的 WhatsApp 服务器,提供与 WhatsApp 交互的标准化接口,通过 GreenAPI 服务实现功能。
View on GitHub

Overview

基本能力

产品定位

WhatsApp MCP Server 是一个基于 MCP 协议的 WhatsApp 服务器实现,提供与 WhatsApp 交互的标准化接口。

核心功能

  • WhatsApp 会话管理
  • 与 GreenAPI 服务的集成
  • 标准化的 MCP 协议实现
  • TypeScript 支持

适用场景

  • 需要与 WhatsApp 进行自动化交互的应用
  • 需要管理多个 WhatsApp 会话的场景
  • 需要发送消息、管理群组等 WhatsApp 功能的自动化工具

工具列表

  1. Open Session: 使用 GreenAPI 凭证打开一个新的 WhatsApp 会话。
  2. Send Message: 向指定聊天发送消息。
  3. Get Chats: 获取可用聊天列表。
  4. Create Group: 创建一个新的 WhatsApp 群组。
  5. Get Chat History: 从指定聊天获取最近的消息。
  6. Send File: 向指定聊天发送文件。
  7. Add Participant: 向现有 WhatsApp 群组添加参与者。
  8. Remove Participant: 从现有 WhatsApp 群组移除参与者。

常见问题解答

  • 要接收聊天历史中的传入消息,需要启用 "Receive webhooks on incoming messages and files" 设置。

使用教程

使用依赖

  • Node.js (v14 或更高版本)
  • npm 或 yarn
  • GreenAPI 账户和凭证

安装教程

  1. 克隆仓库:
git clone <repository-url>
cd whatsapp-mcp-server
  1. 安装依赖:
npm install

配置

需要以下环境变量: - GREENAPI_API_URL: GreenAPI 服务的基础 URL - GREENAPI_API_TOKEN: 您的 GreenAPI API 令牌

调试方式

  1. 启动服务器:
npm start
  1. 服务器将通过标准输入/输出监听 MCP 协议消息。

许可证

None