WhatsApp MCP-Go 服务器
使用说明（简明可操作版本）
-
项目简介
- 本项目实现了一个基于 MCP 协议的后端服务器，专注于通过标准化工具接口为大语言模型客户端提供外部数据访问、功能调用和对话上下文服务。核心组件包括 MCP 服务器、工具注册与处理逻辑，以及与 WhatsApp Bridge 的集成能力。
- 支持两种传输模式：STDIO（嵌入式/本地集成）和 SSE（服务器事件流，便于自动化工作流）。通过 MCP 客户端（如 Claude Desktop、Cursor 等）进行连接与调用。
-
主要功能点
- MCP 服务器实现：按照 MCP 协议处理请求、响应与工具调用，提供稳定的服务边界。
- 工具注册与执行：注册一组与 WhatsApp 相关的工具（如搜索联系人、列出/读取消息、发送消息、下载媒体等），并对外提供统一的输入/输出接口。
- 会话与上下文支持：支持对话历史与上下文数据的查询、获取以及上下文注入，便于 LLM 生成更连贯的回答。
- 安全与认证：通过 JWT/API Key 进行简单的身份验证与访问控制，服务器端实现了令牌获取和刷新逻辑。
- 多传输协议：STDIO 与 SSE 两种传输模式，便于本地集成和云端自动化环境的接入。
-
安装步骤（简明版）
- 安装 Go 运行环境。
- 克隆仓库并进入项目目录。
- 进入 whatsapp-mcp-server 目录并构建服务端，可得到可执行二进制 whatsapp-mcp。
- 配置环境变量（如 WhatsApp API secret、数据库连接信息、JWT 秘钥等），并启动 MCP 服务端。
- 将 MCP 客户端（如 Claude Desktop）的配置指向本服务器，完成连接。
-
服务器配置（MCP 客户端需要的启动信息，JSON 格式，含 server 名称、命令与参数等） 说明：以下示例仅用于描述配置结构，实际请将命令替换为服务器可执行文件的绝对路径，并按需设置环境变量。 { "mcpServers": { "whatsapp-mcp": { "command": "/path/to/whatsapp-mcp-server/whatsapp-mcp", "args": [], "env": { "WHATSAPP_API_SECRET": "your-api-secret", "IS_POSTGRES": "false", "JWT_SECRET": "your-jwt-secret", "API_KEY": "your-api-key" } // 说明：command 指向 MCP 服务器可执行文件的路径，args 为服务器启动参数（如无可为空），env 为服务器所需的环境变量。 } }, "preferences": { "sidebarMode": "chat", "coworkScheduledTasksEnabled": false } }
-
基本使用方法
- 在服务器所在机器启动 MCP 服务器（whatsapp-mcp），确保所需的 WhatsApp Bridge 服务也在运行（如果使用桥接模式）。
- 配置你的 MCP 客户端（ Claude Desktop、Cursor 等）连接到上述 serverName，对应启动命令和参数保持一致。
- 在 MCP 客户端中调用注册的工具，例如 search_contacts、list_messages、send_message 等，服务器将统一处理请求并返回 JSON-RPC 风格的响应内容。
- 如需更新或扩展工具，只需在服务器端的工具注册处增加新的工具定义和处理函数即可。