MCP.so
登录

Chatterbox MCP Server

@Ruandv

基本信息

分类

其他

传输方式

stdio

作者

Ruandv

关于 Chatterbox MCP Server

A MCP server for personal use

Chatterbox MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "chatterbox_mcp_server": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "whatsapp-server",
        "."
      ]
    }
  }
}

Chatterbox MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Chatterbox MCP Server?

Chatterbox MCP Server is a two-component system that provides WhatsApp functionality through the Model Context Protocol (MCP). It consists of an MCP server that exposes WhatsApp operations as MCP tools, and a separate WhatsApp REST API server that handles the actual WhatsApp Web integration. It is designed for developers and users who want to interact with WhatsApp via MCP clients like Claude.

How to use Chatterbox MCP Server?

Set up secret files for both servers, install dependencies with npm run install:all, start the WhatsApp server with npm run dev:whatsapp, then start the MCP server with npm run dev:mcp. Authenticate by visiting http://localhost:3004/qr and scanning the QR code with the WhatsApp mobile app.

Key features of Chatterbox MCP Server

  • Two-component architecture: MCP server and WhatsApp server
  • Provides WhatsApp operations through MCP tools
  • File-based secret management for security
  • Docker support for containerized deployment
  • Headless mode for WhatsApp Web integration
  • Designed for MCP clients like Claude

Use cases of Chatterbox MCP Server

  • Integrate WhatsApp messaging capabilities into MCP-compatible AI assistants
  • Automate WhatsApp tasks such as sending messages or reading chats
  • Build custom workflows that combine WhatsApp with other MCP tools
  • Deploy a self-hosted WhatsApp gateway for personal or team use

常见问题

1

What is the architecture of Chatterbox MCP Server?

The system uses a two-component architecture: an MCP server that communicates with MCP clients via the MCP protocol, and a WhatsApp REST API server that handles the actual WhatsApp Web.js integration. The MCP server makes HTTP API calls to the WhatsApp server.

2

How do I authenticate with WhatsApp?

After starting the WhatsApp server, visit `http://localhost:3004/qr` to get a QR code. Scan it with the WhatsApp mobile app to authenticate.

3

What secrets are required for Chatterbox MCP Server?

Both servers require a shared `CHATTERBOX_SECRET` for authentication. The MCP server also needs a `WHATSAPP_SERVER_URL` and optionally a `SERVER_PORT`. The WhatsApp server needs `PORT` and `HEADLESS` (boolean) settings.

4

What are the dependencies and runtime requirements?

The server requires Node.js, npm, and a browser environment for WhatsApp Web (Puppeteer). Docker is available for containerized deployment.

5

What data does Chatterbox MCP Server store?

The README does not specify data storage. Secrets are stored in plain text files in the `secrets/` directory. Message data would be handled by the WhatsApp Web session.

评论

其他 分类下的更多 MCP 服务器