WhatsApp Message Sender MCP Tool

WhatsApp 消息发送器 MCP 工具

这是一个 MCP（模型上下文协议），使用 Meta（Facebook）WhatsApp Business API 发送 WhatsApp 消息。

要求

• Python 3.12 或更高版本
• uv（Python 包管理器）
• Meta WhatsApp Business API 凭据

安装

1. 克隆仓库：

git clone https://github.com/deuslirio/mcp-server-whatsapp-message.git
cd mcp-server-whatsapp-message

2. 使用 uv 安装依赖项：

uv pip install -e .

运行服务

独立模式

使用以下命令启动服务：

uv run python main.py

服务将运行并准备好接收请求。

与 Claude Local 集成

要将此工具添加到 Claude Local 配置中，请将以下内容添加到 Claude 的配置中：

{
    "mcpServers": {
        "whatsapp": {
            "command": "uv",
            "args": [
                "run",
                "\\\\wsl.localhost\\Ubuntu-24.04\\home\\deuslirio\\PycharmProjects\\mcp-server-whatsapp-message\\main.py"
            ],
            "env": {
                "META_ACCESS_TOKEN": "your-token-here",
                "META_PHONE_NUMBER_ID": "your-phone-id-here"
            }
        }
    }
}

注意：请将环境变量的值替换为你实际的 Meta API 凭据。

可用工具

send_whatsapp_message

向指定电话号码发送 WhatsApp 消息。

参数：

• phone_number：收件人的电话号码（字符串，国际格式，例如 +5562995631588）
• message：要发送的消息（字符串）

使用示例：

{
    "phone_number": "+5562000000000",
    "message": "Hello! This is a test message!"
}

可用资源

contacts

返回包含联系人姓名和电话号码的列表。

URI：resource://contacts

响应示例：

[
    {"name": "João da Silva", "phone_number": "+55629999999999"}
]

演示

以下是 WhatsApp 消息发送器 MCP 工具运行效果的截图：

发送消息

接收消息

使用联系人资源

已接收的消息

故障排除

常见问题

1. FastMCP 导入错误：

   • 请确认已正确安装 mcp 包：

     uv pip install mcp==1.6.0
     

2. 环境变量错误：

   • 确保已在 Claude Local 配置中正确设置环境变量
   • 确认变量值正确

3. 使用 uv run 运行时出错：

   • 尝试清除 uv 缓存：

     uv cache clean
     

   • 重新安装依赖项：

     uv pip install -e .
     

项目结构

mcp-server-whatsapp-message/
├── main.py                  # Server entry point
├── mcp_server/              # Main module
│   ├── __init__.py          # Module initialization
│   └── whatsapp_handler.py  # WhatsApp message handler
├── pyproject.toml           # Project configuration
├── requirements.txt         # Project dependencies
└── .env                     # Environment variables (not versioned)

参与贡献

欢迎贡献！欢迎提交问题或拉取请求。