MCP WhatsApp Server

MCP WhatsApp 服务

基于 Model Context Protocol (MCP) 的服务器，通过 Waha API 集成 WhatsApp。

项目介绍

此服务器可让兼容 MCP 的 AI 助手（如 Claude）直接与 WhatsApp 联系人互动。项目使用 Waha API 作为与 WhatsApp Web 通信的后端。

功能

• ✅ 检查 WhatsApp 连接状态
• ✅ 通过电话号码发送消息
• ✅ 通过已登记的联系人姓名发送消息
• ✅ 按姓名管理联系人
• ✅ 查看服务器配置

要求

• Python 3.7+
• 正在运行的 Waha API
• MCP 库（Fast MCP）

安装

1. 克隆此仓库：

   git clone https://github.com/seu-usuario/mcp-whatsapp-server.git
   cd mcp-whatsapp-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 在 .env 文件中配置环境变量：

   WAHA_API_URL=http://localhost:3000
   WAHA_SESSION_ID=default
   CONTATOS_FILE=caminho/para/contatos.json (opcional)
   

4. 在 contatos.json 文件中配置联系人：

   {
       "contatos": {
           "Nome1": "5511999999999",
           "Nome2": "5522888888888"
       }
   }
   

使用方法

1. 按照官方说明启动 Waha API

2. 运行 MCP 服务：

   python server.py
   

3. 使用兼容的 MCP 客户端（如 Claude Desktop）连接此服务

可用的 MCP 资源

资源

• waha://configuracao - Waha API 配置
• waha://status - 当前 WhatsApp 连接状态
• waha://contatos - 按姓名映射的联系人列表

工具

• verificar_conexao_whatsapp() - 检查当前连接状态
• enviar_mensagem_whatsapp(numero, mensagem) - 按号码发送消息

示例

检查连接状态

status = verificar_conexao_whatsapp()
print(f"Status: {status['mensagem']}")

按号码发送消息

resultado = enviar_mensagem_whatsapp("5511999999999", "Olá! Esta é uma mensagem de teste.")
print(f"Resultado: {resultado['mensagem']}")

按姓名发送消息

resultado = enviar_mensagem_por_nome("Pedro", "Olá! Esta é uma mensagem de teste.")
print(f"Resultado: {resultado['mensagem']}")

贡献

欢迎贡献！欢迎提交 issues 或 pull request。

许可证

此项目采用 MIT 许可证。

图片和演示

使用示例