实时消息服务

一个基于Pusher Channels的MCP服务器,为AI代理提供发送实时消息、查询频道和管理用户的功能。

  • by CrashBytes
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 CrashBytes/pusher-mcp-server

使用说明

推送通道MCP服务器

一 MCP(模型上下文协议) 服务器,使AI代理能够通过以下方式发送实时消息、查询通道和管理用户 推杆通道.

工具

工具 说明
trigger_event 将事件发送到一个或多个频道
trigger_batch_events 在单个API调用中发送多达10个事件
list_channels 列出带有可选前缀过滤器的活动频道
get_channel_info 获取频道的订阅数/用户数
get_presence_users 列出连接到状态频道的用户
authorize_channel 为私有/在线通道生成身份验证令牌
terminate_user_connections 断开用户的所有连接

先决条件

  • Node.js 18或更高版本
  • A. 推杆通道 帐户(可用免费等级)

安装

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_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 视窗: %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代码

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

在运行之前在shell中设置环境变量,或在Claude Code MCP设置中配置它们。

示例提示

配置后,您可以向Claude询问以下问题:

  • “向通知通道发送“部署完成”事件,并显示消息“v2.1.0已部署””
  • “显示所有活动状态频道”
  • “状态大厅频道上有多少用户?”
  • “断开用户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.

许可证

麻省理工学院