MCP Whatsapp Server

🚀 基於 MCP 協議的 WhatsApp 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，藉助 API Waha 實現與 WhatsApp 的集成。它能讓兼容 MCP 的 AI 助手（如 Claude）直接和 WhatsApp 上的聯繫人進行交互。

🚀 快速開始

此服務器允許兼容 MCP 的 AI 助手（如 Claude）直接與 WhatsApp 上的聯繫人交互。項目使用 Waha API 作為後端，實現與 WhatsApp Web 的通信。

✨ 主要特性

• ✅ 驗證 WhatsApp 連接狀態
• ✅ 通過手機號發送消息
• ✅ 通過已註冊的聯繫人姓名發送消息
• ✅ 管理聯繫人（按名稱）
• ✅ 查看服務器配置

📦 安裝指南

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"
       }
   }
   

💻 使用示例

基礎用法

按照 官方說明 啟動 Waha API，運行 MCP 服務器：

python server.py

使用兼容的 MCP 客戶端（如 Claude Desktop）與服務器交互。

高級用法

驗證連接狀態

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']}")

📚 詳細文檔

可用的 MCP 資源

資源

• waha://configuracao - Waha API 配置
• waha://status - WhatsApp 當前連接狀態
• waha://contatos - 按名稱映射的聯繫人列表

工具（Tools）

• verificar_conexao_whatsapp() - 驗證當前 WhatsApp 連接狀態
• enviar_mensagem_whatsapp(numero, mensagem) - 通過手機號發送消息

📄 許可證

該項目根據 MIT License 發佈。