AI导哈

WhatsApp HTTP API 服务器

MCP Waha Server 是一个用于与 WhatsApp HTTP API 交互的服务器，支持列出消息、发送消息和管理聊天。

  • by GabsPereiraDev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 GabsPereiraDev/mcp-waha

使用说明

MCP Waha服务器

这是一个MCP（模型上下文协议）服务器，用于与Waha（WhatsApp HTTP API）交互。 它允许您直接通过Trae或Claude Desktop等MCP客户端列出消息，发送消息和管理聊天。

可用工具

  • list_chats列出可用的聊天。
  • list_messages列出特定聊天中的消息。
    • chatId （必填）： 聊天ID（例如： 1234567890@c.us).
    • limit （可选）：消息数量（默认：10）。
  • send_message向聊天发送文本消息。
    • chatId （必填）：聊天ID。
    • text （必填）：消息内容。
  • get_me: 返回当前 Waha 会话的信息。

安装

  1. 克隆此仓库 。
  2. 安装依赖关系 ：
    npm install
  3. 编译工程 ：
    npm run build

配置

服务器使用环境变量进行配置 。您可以创建一个文件 .env 基于 .env.example 或者直接在MCP客户端配置中传递变量。

变量 ：

  • WAHA_API_URLWaha API 的基础 URL （例如： http://localhost:3000).
  • WAHA_SESSION: Waha 会话名称（ 默认 ： default).
  • WAHA_API_KEYAPI密钥（如果需要）。

与Trae / Claude Desktop集成

将以下设置添加到您的 MCP 服务器配置文件（例如： claude_desktop_config.json 或在 Trae 设置中：

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["/caminho/para/mcp-waha/dist/index.js"],
      "env": {
        "WAHA_API_URL": "http://localhost:3000",
        "WAHA_SESSION": "default",
        "WAHA_API_KEY": "sua_chave_secreta"
      }
    }
  }
}

请确保您设置了文件路径 dist/index.js 和环境变量根据您的配置。

发展

要在开发模式下运行：

npm run dev

相关 MCP