Whatsapp MCP Local Ollam

🚀 WhatsApp Python 自動化工具

這是一個基於 Python 的自動化工具，藉助 WhatsApp 網頁界面實現消息發送功能，能有效提升溝通效率。

🚀 快速開始

此工具允許您通過 WhatsApp 網頁界面實現消息自動化發送。使用前，請確保滿足先決條件，並完成安裝步驟，之後即可按照使用方法操作。

✨ 主要特性

• 可向單個聯繫人或群組發送消息。
• 安裝過程簡單，易於上手使用。
• 採用 Python 實現自動化操作。
• 與 WhatsApp Web 完美兼容。

📦 安裝指南

先決條件

• Python 3.6 或更高版本。
• Go（版本 1.16 或更高）。
• Chrome/Firefox 瀏覽器。
• 活躍的 WhatsApp 賬戶。
• 網絡連接。

Windows 特定要求

對於 Windows 用戶，需要額外進行如下配置：

1. 安裝 Go：
   • 從 官方網址 下載 Go。
   • 運行安裝程序。
   • 若未自動添加，需將 Go 添加到系統 PATH 中。
   • 通過在命令提示符中運行 go version 驗證安裝情況。
2. 啟用 CGO：
   • 打開命令提示符並運行：go env -w CGO_ENABLED=1。
3. 安裝 C 編譯器：
   • 下載並安裝 MSYS2。
   • 打開 MSYS2 並運行：pacman -S mingw-w64-x86_64-gcc。
   • 將 C:\msys64\mingw64\bin 添加到系統 PATH 中。

安裝步驟

1. 克隆此倉庫：

git clone [your-repository-url]
cd whatsapp-python

2. 安裝所需的依賴項：

pip install -r requirements.txt

💻 使用示例

基礎用法

1. 切換到項目目錄：

cd whatsapp-bridge

2. 運行 WhatsApp 代理程序：

go run main.go
# 這將啟動 WhatsApp mcp 服務器

3. 第一次運行時，您需要：
   • 使用 WhatsApp 移動應用程序掃描 QR 碼。
   • 等待身份驗證完成。
   • 保持手機連接到互聯網。
4. 要發送消息，請使用以下格式：

python whatsapp_message.py
# 這將運行 ai 並通過我們的 mcp 連接
send message to "接收方名稱" "您的消息"

例如：向 chau 發送消息 say hi / # 請記住要手動在 json 中添加聯繫人才能加載它

高級用法

def send_message():
    # 在此處添加發送消息的邏輯
    pass

if __name__ == "__main__":
    send_message()

📚 詳細文檔

工作原理

該應用程序的工作流程如下：

1. 自動化一個網絡瀏覽器會話。
2. 連接到 WhatsApp 網頁版。
3. 通過 QR 碼進行身份驗證（僅限首次）。
4. 在您的聯繫人中查找收件人。
5. 使用 ollam 發送指定的消息。

注意事項

• 保持 WhatsApp 手機應用程序連接到互聯網。
• 不要關閉終端中的服務器窗口。
• 確保收件人在您的 WhatsApp 聯繫人中。
• 會話需要定期重新身份驗證，例如每 20 天一次。
• 對於 Windows 用戶，請確保 CGO 已啟用且 C 編譯器已正確配置。

故障排除

如果遇到問題：

1. 確保互聯網連接穩定。
2. 驗證您的 WhatsApp 賬戶是否活躍。
3. 檢查是否有足夠的權限執行操作。

📄 許可證

[在此處添加許可證信息]

⚠️ 重要提示

此工具旨在提高效率，但請負責任地使用。