Pusher Channels

Pusher Channels MCP 服务

这是一个 MCP（Model Context Protocol） 服务，可让 AI Agent 通过 Pusher Channels发送实时消息、查询频道并管理用户。

工具

工具	描述
trigger_event	向一个或多个频道发送事件
trigger_batch_events	在一次 API 调用中最多发送 10 个事件
list_channels	列出活跃频道，可选择按前缀筛选
get_channel_info	获取频道的订阅数／用户数
get_presence_users	列出已连接到 presence 频道的用户
authorize_channel	为 private／presence 频道生成身份验证令牌
terminate_user_connections	断开某个用户的所有连接

前置条件

• Node.js 18 或更高版本
• 一个 Pusher Channels 账户（提供免费套餐）

安装

npm install -g @crashbytes/pusher-mcp-server

或者克隆并从源代码构建：

git clone https://github.com/CrashBytes/pusher-mcp-server.git
cd pusher-mcp-server
npm install
npm run build

配置

你需要从 Pusher 控制面板获取以下四个环境变量：

变量	描述
PUSHER_APP_ID	你的 Pusher 应用 ID
PUSHER_KEY	你的 Pusher 应用密钥
PUSHER_SECRET	你的 Pusher 应用密钥
PUSHER_CLUSTER	你的 Pusher 集群（例如 us2、eu、ap1）

在 Claude Desktop 中使用

将以下内容添加到 Claude Desktop 配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pusher": {
      "command": "node",
      "args": ["/path/to/pusher-mcp-server/build/index.js"],
      "env": {
        "PUSHER_APP_ID": "your_app_id",
        "PUSHER_KEY": "your_app_key",
        "PUSHER_SECRET": "your_app_secret",
        "PUSHER_CLUSTER": "us2"
      }
    }
  }
}

如果通过 npm 全局安装：

{
  "mcpServers": {
    "pusher": {
      "command": "pusher-mcp-server",
      "env": {
        "PUSHER_APP_ID": "your_app_id",
        "PUSHER_KEY": "your_app_key",
        "PUSHER_SECRET": "your_app_secret",
        "PUSHER_CLUSTER": "us2"
      }
    }
  }
}

在 Claude Code 中使用

claude mcp add pusher -- node /path/to/pusher-mcp-server/build/index.js

运行前，请在 shell 中设置环境变量，或在 Claude Code 的 MCP 设置中进行配置。

提示词示例

配置完成后，你可以向 Claude 提出以下请求：

• “向 notifications 频道发送一个 'deploy-complete' 事件，消息内容为 'v2.1.0 deployed'”
• “显示所有活跃的 presence 频道”
• “presence-lobby 频道中有多少用户？”
• “断开用户 abc123 在所有频道中的连接”

开发

npm install
npm run dev          # Run with tsx (hot reload)
npm run build        # Compile TypeScript
npm run type-check   # Check types without emitting

教程

如需了解从头构建此服务的分步指南，请参阅 CrashBytes 上的完整教程。

许可证

MIT