← 返回目录

wacrm MCP Server

社区

通过 MCP 从 Claude、Cursor 等 AI 助手驱动自托管的 wacrm WhatsApp CRM。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 51 / 55
Stars: ★ 2.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 4 天前

36FMRS · D

该服务器为 wacrm 用户提供了与 AI 助手集成的便捷方式，但需注意权限和风险控制。

最强项 · 安全与权限 10/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

10/20

维护活跃度

8/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 3/20: 已提供格式良好的 manifest，描述了一个似乎合理的 stdio npm MCP 服务器，但未提供服务器源码、测试或针对 MCP 服务器的 CI 工作流。没有可验证的证据证明 init 和工具列表握手能够成功，也没有证据表明声明的工具与实际行为一致。由于缺少可执行证据和已提交的测试，按静态校准规则扣分；上限为 12，未达到该上限。
安全与权限 10/20: 未发现红线问题。API 密钥被标记为机密，写入操作默认关闭，需要显式设置 WACRM_ENABLE_WRITES=true；广播操作还需要额外设置 WACRM_ENABLE_BROADCASTS，体现了较好的最小权限默认值。扣分点：没有源码可验证工具是否真正执行 API 密钥作用域，写入/广播操作没有文档化的确认流程，也没有对外部 WhatsApp 调用的数据流披露。因此处于“主要风险可见、但权限/确认/范围界定不完整”的 10 分档。
维护活跃度 8/20: 仓库未归档，采用 MIT 许可证，包版本为 0.1.1。但未提供发布历史、提交节奏、依赖更新证据或安全响应渠道；星标仅作为发现信号，不计入分数。由于缺少治理和版本管理方面的证据，无法给满 10 分以上，故给 8 分。
文档质量 8/20: README 提供了产品概述，并指向 docs/mcp.md 和公开 API 文档；manifest 也解释了各环境变量的含义。但未提供 MCP 专属文档细节：没有工具参数参考、作用域/限制说明、成本指导或故障排查章节。因缺少工具级文档和故障排查内容而扣分，评分定为 8。
安装易用性 7/20: manifest 明确声明了 npm 标识、stdio 传输方式以及必需的环境变量，安装路径看起来可行。但未提供 MCP 客户端（Claude/Cursor）配置示例、前置条件清单或安装验证步骤。安装路径可行但未经过验证，且静态校准上限为 15，缺乏执行证据，故评分为 7。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用 wacrm 的团队或个人，希望通过 AI 助手提高 CRM 操作效率
需要自托管、完全控制数据和配置的开发者

不适合谁

不使用 wacrm 或 WhatsApp Business API 的用户
需要官方、由上游维护的 MCP 服务器的用户（此服务器由社区维护）

所需权限

需要 wacrm 实例的 API 密钥，权限范围由密钥 scopes 决定
默认只读；启用 WACRM_ENABLE_WRITES 后可创建/更新联系人、发送消息
启用 WACRM_ENABLE_BROADCASTS 后可执行群发广播

风险与副作用

API 密钥泄露可能导致数据访问或操作
启用写入或广播后，AI 可能执行意外操作
自托管实例的配置错误可能导致连接失败

安装接入

准备工作

运行环境：Node.js

WACRM_BASE_URL 必填你的自托管 wacrm 实例地址，例如 https://crm.example.com，即你部署 CRM 的域名。

WACRM_API_KEY 必填密钥 wacrm 的 API 密钥，在 CRM 的 Settings → API keys 中生成，其权限范围决定允许的操作。

其他可选配置项（2 个）

WACRM_ENABLE_WRITES 可选设为 true 才会开放联系人创建/更新和消息发送工具；未设置时为只读。

WACRM_ENABLE_BROADCASTS 可选设为 true 才会开放群发广播工具，且需要先设置 WACRM_ENABLE_WRITES。

通过 npm 安装 wacrm-mcp 包，并配置环境变量：WACRM_BASE_URL（wacrm 实例的基础 URL）、WACRM_API_KEY（在设置中生成的 API 密钥）、WACRM_ENABLE_WRITES（设为 true 以启用写入）、WACRM_ENABLE_BROADCASTS（设为 true 以启用广播，需同时启用写入）。

验证是否装好

在 MCP 客户端的工具列表中确认 wacrm 工具已出现，然后询问一个只读问题（如列出联系人），能返回你 wacrm 实例中的真实数据即说明连接成功。

常见排障

检查 WACRM_BASE_URL 是否可从 MCP 客户端访问
确认 API 密钥有效且具有所需权限
确保环境变量正确设置，尤其是启用写入时的 WACRM_ENABLE_WRITES

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我 wacrm CRM 中的所有联系人
查看最近打开的会话及其分配情况
把客户 John 加上 vip 标签
通过 WhatsApp 给客户发一条回复

使用场景

从 AI 助手查看联系人、对话和管道数据

通过 AI 起草回复（需启用写入）

运行无代码自动化或广播（需相应权限）

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

此 MCP 服务器允许 AI 助手（如 Claude 和 Cursor）与自托管的 wacrm 实例交互，wacrm 是一个基于 WhatsApp Business API 的 CRM 模板，提供共享收件箱、联系人管理、销售管道、群发消息和无代码自动化功能。默认只读，可选择启用写入和广播功能。