WhatsApp Python Automation

WhatsApp Python Automation

使用 MCP 和 Ollama 的 WhatsApp 消息传递 这个项目将 PraisonAI Agents 与 Ollama (llama3.2) 和一个基于 Go 的 WhatsApp 桥接器集成在一起。它允许你通过本地 REST API,使用自然语言发送 WhatsApp 消息,该 API 由 LLM 和自定义 MCP 工具驱动。

AakibAnsarime

开发者工具
访问服务器

README

WhatsApp Python 自动化

这是一个基于 Python 的 WhatsApp 自动化工具,允许您使用 WhatsApp Web 的界面以编程方式发送消息。

功能

  • 向个人联系人或群组发送消息
  • 易于设置和使用
  • 使用 Python 进行自动化
  • 适用于 WhatsApp Web

前提条件

  • Python 3.6 或更高版本
  • Go (1.16 或更高版本)
  • Chrome/Firefox 浏览器
  • 活跃的 WhatsApp 帐户
  • 互联网连接

Windows 特定要求

对于 Windows 用户,需要进行额外的设置:

  1. 安装 Go:

    • 官方网站 下载 Go
    • 运行安装程序
    • 如果未自动完成,请将 Go 添加到您的系统 PATH
    • 通过在命令提示符中运行 go version 来验证安装
  2. 启用 CGO:

    • WhatsApp 桥接器需要 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
  1. 安装所需的依赖项:
pip install -r requirements.txt

用法

  1. 导航到项目目录:
cd whatsapp-bridge
  1. 运行 WhatsApp 桥接器:
go run main.go
# 这将启动 whatsapp mcp 服务器
  1. 首次运行时,您需要:

    • 使用您的 WhatsApp 移动应用程序扫描二维码
    • 等待身份验证过程完成
    • 保持您的手机连接到互联网
  2. 要发送消息,请使用以下格式:

python whatsapp_message.py
# 这将使用我们的 mcp 连接运行 ai
send message to "recipient_name" "your message"

eg: send message to chau say hi  /# 记住手动将联系人添加到 json,以便加载它

工作原理

该应用程序的工作原理是:

  1. 自动化 Web 浏览器会话
  2. 连接到 WhatsApp Web
  3. 通过二维码进行身份验证(仅首次)
  4. 在您的联系人中找到收件人
  5. 使用 ollam 发送指定的消息

重要提示

  • 保持您的 WhatsApp 手机应用程序连接到互联网
  • 发送消息时不要关闭终端中的服务器
  • 确保收件人在您的 WhatsApp 联系人中
  • 会话需要定期重新验证,例如 20 天
  • 对于 Windows 用户,请确保已启用 CGO 并且 C 编译器已正确配置

故障排除

如果您遇到问题:

  1. 确保您有稳定的互联网连接
  2. 验证您的 WhatsApp 帐户是否处于活动状态
  3. 确保收件人的姓名与您联系人中显示的姓名完全匹配
  4. 如果身份验证失败,请尝试重新运行脚本

Windows 特定问题

如果您遇到如下错误:

  • Binary was compiled with 'CGO_ENABLED=0': 确保已启用 CGO
  • gcc: command not found: 验证 MSYS2 安装和 PATH
  • missing go.sum entry: 在 whatsapp-bridge 目录中运行 go mod tidy

贡献

随意:

  • 报告错误
  • 建议功能
  • 提交拉取请求

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

免责声明

此工具仅用于教育目的。请负责任地使用,并遵守 WhatsApp 的服务条款。

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。

官方
本地
JavaScript