Whatsapp Gemini MCP

MCPAI代理

提供方 akashkumar2k01

AI代理 未标注 无需鉴权 社区 / 第三方

一个连接 WhatsApp 和 Gemini CLI 的本地 MCP 服务器,支持读取、搜索和发送 WhatsApp 消息。

一句话选型结论

按资料字段整理

Whatsapp Gemini MCP 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 14 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量14暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

WhatsApp集成Go本地部署终端工具本地运行消息管理AI助手

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 14 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 14 个工具,覆盖面较广,能满足多种调用。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Whatsapp Gemini MCP当前 14 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方akashkumar2k01上游标注的维护方 akashkumar2k01
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.2 KB
来自项目仓库与上游目录的原文,未做删改

×

WhatsApp MCP Server

Connect Gemini CLI to WhatsApp in one command.

Read messages · Search contacts · Send texts, images & voice notes — all from your terminal.


✨ 它的作用

A. 模型上下文协议(MCP) 将您的个人WhatsApp帐户连接到的服务器 Gemini CLI。你的人工智能助手现在可以阅读、搜索和发送WhatsApp消息——所有这些都在你的机器上本地运行。

  • 💬 阅读和搜索 您所有聊天记录中的消息
  • 👤 搜索联系人 按姓名或电话号码
  • 📤 发送消息 个人或团体
  • 📎 发送和下载媒体 --图像、视频、文档、语音备忘
  • 🔒 100%本地 --消息保留在本地SQLite数据库中,仅在使用工具时发送到LLM
  • ⚡ 一个命令 开始

> 它是如何工作的: Go桥接通过连接到WhatsApp的多设备API 怎么回事,在本地存储消息,并公开REST API。Python MCP服务器将Gemini CLI工具调用转换为桥接API请求。


🚀 快速开始

先决条件

要求 · 安装
去 ≥ 1.21 · golang.org/dl
python ≥ 3.11 · python.org
紫外线 (Python pkg管理器) · curl -LsSf https://astral.sh/uv/install.sh \ · sh
Gemini CLI · github.com/google-gemini/gemini-cli
FFmpeg (可选) · 只需要将音频自动转换为语音备忘

两步——就是这样

步骤1→ 克隆和设置```bash
git clone https://github.com/akashkumar2k01/whatsapp-gemini-mcp.git
cd whatsapp-gemini-mcp
./setup.sh


> 这将构建Go桥,安装Python依赖项,并自动生成Gemini CLI配置。 **无需手动编辑路径。**

**步骤2→ 启动桥梁**```bash
./start.sh

> 📱 仅限首次运行: 二维码图像会自动打开——用 WhatsApp→ 设置→ 链接设备→ 链接设备配对后,会话持续约20天。

完成。 打开Gemini CLI,开始与您的WhatsApp数据聊天。 🎉```bash
gemini


📋 What setup.sh does

1. ✅ 检查先决条件(Go、Python、uv)
1. 📁 创造 `~/.whatsapp-gemini-mcp/` 数据目录
1. 🔨 构建Go桥二进制文件
1. 📦 通过以下方式安装Python依赖项 `uv sync`
1. ⚙️ 自动生成 `~/.gemini/settings.json` 使用WhatsApp MCP配置
1. 🔄 如果您使用的是旧版本,则迁移现有会话数据

🪟 Windows users — extra CGO step

`go-sqlite3` 需要Windows上的CGO:

1. 安装 Msys 2 并添加 `ucrt64\bin` 致你的 `PATH` (引导)
1. 运行前启用CGO:```bash
go env -w CGO_ENABLED=1
./setup.sh

📂 数据所在之处

所有WhatsApp数据都存储在 ~/.whatsapp-gemini-mcp/ --与您克隆repo的位置无关:

文件 目的
whatsapp.db WhatsApp会话和身份验证
messages.db 您的所有消息(带WAL模式的SQLite)
whatsapp_qr.png 二维码图像(仅在身份验证期间)
media/ 已下载的媒体文件

> 这意味着你可以在任何地方克隆仓库, cd 进入任何目录,一切正常。没有“错误目录”错误。


🛠 可用工具

工具 说明
check_bridge_health 验证Go桥是否正在运行 (如有问题,请先使用)
get_qr_status 检查是否需要QR重新验证
search_contacts 按姓名或电话号码搜索联系人
list_chats 使用过滤器、分页和排序列出聊天记录
get_chat 通过JID获取单聊天元数据
list_messages 使用日期/发件人/关键字过滤器搜索邮件
get_message_context 获取周围的消息以获取上下文
get_last_interaction 联系人的最新消息
get_direct_chat_by_contact 通过电话号码查找DM聊天
get_contact_chats 所有涉及联系人的聊天
send_message 向电话号码或JID发送文本
send_file 发送图像、视频或文档
send_audio_message 发送语音备忘(自动转换为ogg/opus)
download_media 将媒体从邮件下载到磁盘

JID格式

  • 个人的: 919876543210@s.whatsapp.net (国家代码+编号)
  • 组: 120363XXXXXXXX@g.us

🏗 建筑```

┌───────────────┐ stdio (MCP JSON-RPC) ┌───────────────────┐
│ Gemini CLI │◄─────────────────────────────────►│ Python MCP │
│ │ │ Server (main.py) │
└───────────────┘ └────────┬──────────┘
│ HTTP :8080
▼
┌────────────────────┐
│ Go WhatsApp │
│ Bridge (main.go) │
└────────┬───────────┘
│ whatsmeow
▼
┌────────────────────┐
│ WhatsApp Web API │
└────────────────────┘


|组件|角色|
|-----------|------|
| **Go Bridge** (`bridge/`)|通过多设备API连接到WhatsApp,处理QR验证,在SQLite中存储消息,在上提供REST API `:8080` |
| **Python MCP服务器** (`mcp-server/`)|通过stdio实现MCP协议,将工具调用转换为桥接REST调用|
| **SQLite商店** (`~/.whatsapp-gemini-mcp/`)|用于消息、聊天和会话数据的本地数据库——永远不会离开您的计算机|

### 数据流```
Send:    Gemini CLI → MCP Server → Go Bridge → WhatsApp API → Recipient
Receive: WhatsApp API → Go Bridge → SQLite → MCP Server → Gemini CLI

📎 媒体处理

发送媒体

方法 用例
send_file 图像、视频、文档——任何文件类型
send_audio_message 语音备忘(使用FFmpeg自动转换为ogg/opus)

> 如果没有FFmpeg,请使用 send_file 对于音频,它不会显示为可播放的语音备忘,但文件会被发送。

下载媒体

媒体元数据会自动存储。要下载实际文件,请执行以下操作:Use the download_media tool with message_id and chat_jid → Returns the local file path for viewing or further processing


🔧 故障排除

问题 修复
无法到达桥梁 快跑 check_bridge_health 工具,确保 ./start.sh 正在运行
二维码未显示 QR另存为 ~/.whatsapp-gemini-mcp/whatsapp_qr.png 并自动打开;手动检查文件
首次运行时发生WebSocket错误 网桥会自动重试3次。检查您的互联网连接
已达到设备限制 在WhatsApp中删除设备→ 设置→ 链接设备
邮件未加载 对于大型帐户,初始历史同步可能需要几分钟时间
不同步 删除 ~/.whatsapp-gemini-mcp/messages.db 和 ~/.whatsapp-gemini-mcp/whatsapp.db,重新启动网桥
uv权限错误 快跑 which uv 并在配置中使用完整路径
音频转换失败 安装FFmpeg: brew install ffmpeg (macOS)或 apt install ffmpeg (Linux)

🔒 安全与隐私

  • 所有数据都保留在本地 --消息存储在您计算机上的SQLite中
  • 无云同步 -该桥直接连接到WhatsApp的API
  • 您控制访问权限 --set "trust": false 在设置中批准每个工具调用
  • 敏感文件 — ~/.whatsapp-gemini-mcp/ 目录包含您的完整消息历史记录;它存储在您的主目录中,并从git中排除

📄 许可证

麻省理工学院


If this project helped you, consider giving it a ⭐
Built with ❤️ by AKASHKUMAR SENTHIL (AK) — using Go, Python, and the Model Context Protocol

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Whatsapp Gemini MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Whatsapp Gemini MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Whatsapp Gemini MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Whatsapp Gemini MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Whatsapp Gemini MCP 能提供哪些能力?

资料显示约 14 个工具;能力标签包括 本地运行、Go、消息管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。