基于 MCP 协议的 WhatsApp 服务器

一个基于 Model Context Protocol (MCP) 的服务器，用于通过 API Waha 实现与 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 - 按名称映射的联系人列表

工具（Tools）

• verificar_conexao_whatsapp() - 验证当前 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']}")

贡献

欢迎贡献！随时欢迎提出问题或提交拉取请求。

许可证

该项目根据 MIT License 发布。

图片和演示

• 示例 1: 如何克隆仓库

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

• 示例 2: 如何安装依赖项

  pip install -r requirements.txt
  

• 示例 3: 如何运行服务器

  python server.py
  

• 示例 4: 配置环境变量

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

• 示例 5: 联系人配置文件

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

• 示例 6: 验证连接状态

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

• 示例 7: 发送消息

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

• 示例 8: 通过姓名发送消息

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

• 示例 9: 贡献指南 欢迎提交问题或拉取请求以改进项目。

• 示例 10: 许可证文件路径

LICENSE