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 用户,需要进行额外的设置:
-
安装 Go:
- 从 官方网站 下载 Go
- 运行安装程序
- 如果未自动完成,请将 Go 添加到您的系统 PATH
- 通过在命令提示符中运行
go version来验证安装
-
启用 CGO:
- WhatsApp 桥接器需要 CGO 才能正常工作
- 打开命令提示符并运行:
go env -w CGO_ENABLED=1
-
安装 C 编译器:
- 下载并安装 MSYS2
- 打开 MSYS2 并运行:
pacman -S mingw-w64-x86_64-gcc - 将
C:\msys64\mingw64\bin添加到您的系统 PATH
安装
- 克隆此存储库:
git clone [your-repository-url]
cd whatsapp-python
- 安装所需的依赖项:
pip install -r requirements.txt
用法
- 导航到项目目录:
cd whatsapp-bridge
- 运行 WhatsApp 桥接器:
go run main.go
# 这将启动 whatsapp mcp 服务器
-
首次运行时,您需要:
- 使用您的 WhatsApp 移动应用程序扫描二维码
- 等待身份验证过程完成
- 保持您的手机连接到互联网
-
要发送消息,请使用以下格式:
python whatsapp_message.py
# 这将使用我们的 mcp 连接运行 ai
send message to "recipient_name" "your message"
eg: send message to chau say hi /# 记住手动将联系人添加到 json,以便加载它
工作原理
该应用程序的工作原理是:
- 自动化 Web 浏览器会话
- 连接到 WhatsApp Web
- 通过二维码进行身份验证(仅首次)
- 在您的联系人中找到收件人
- 使用 ollam 发送指定的消息
重要提示
- 保持您的 WhatsApp 手机应用程序连接到互联网
- 发送消息时不要关闭终端中的服务器
- 确保收件人在您的 WhatsApp 联系人中
- 会话需要定期重新验证,例如 20 天
- 对于 Windows 用户,请确保已启用 CGO 并且 C 编译器已正确配置
故障排除
如果您遇到问题:
- 确保您有稳定的互联网连接
- 验证您的 WhatsApp 帐户是否处于活动状态
- 确保收件人的姓名与您联系人中显示的姓名完全匹配
- 如果身份验证失败,请尝试重新运行脚本
Windows 特定问题
如果您遇到如下错误:
Binary was compiled with 'CGO_ENABLED=0': 确保已启用 CGOgcc: command not found: 验证 MSYS2 安装和 PATHmissing go.sum entry: 在 whatsapp-bridge 目录中运行go mod tidy
贡献
随意:
- 报告错误
- 建议功能
- 提交拉取请求
许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。
免责声明
此工具仅用于教育目的。请负责任地使用,并遵守 WhatsApp 的服务条款。
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
MCP Package Docs Server
促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。
Claude Code MCP
一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。
@kazuph/mcp-taskmanager
用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。
mermaid-mcp-server
一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。
Jira-Context-MCP
MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。
Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。
Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。
Curri MCP Server
通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。