AI导哈

WhatsApp消息发送工具

一个基于Meta WhatsApp Business API的MCP协议工具，用于发送WhatsApp消息和管理联系人。

  • by deuslirio
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 deuslirio/mcp-server-whatsapp-message

使用说明

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
  1. 使用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_消息

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

参数:

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

用法示例:

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

可用资源

联系人

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

统一资源标识符: 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)

贡献

欢迎投稿！请随时打开问题或提交pull请求。

相关 MCP