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

1. 编译工程 ：

   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