内容
[English](README.md) | [中文](README.zh-CN.md)
# BotBell 消息推送服务器
[](https://lobehub.com/mcp/qq418716640-botbell-mcp)
[](https://glama.ai/mcp/servers/qq418716640/botbell-mcp)
让 AI 助手向您的 iPhone / Mac 发送推送通知。
## 功能介绍
设置完成后，您的 AI 助手（Claude、Cursor 等）可以：
- **发送通知** — 任务结果、警报、提醒推送到您的手机
- **读取您的回复** — 您在 BotBell 应用中回复，AI 读取并继续
- **管理您的机器人** — 列出、创建机器人（仅限 PAT 模式）
## 认证模式
BotBell 消息推送服务器支持两种令牌类型，自动通过前缀检测：
| 令牌类型 | 前缀 | 范围 | 适用场景 |
|------------|--------|-------|----------|
| **机器人令牌** | `bt_` | 单个机器人 | 简单设置，一个机器人 |
| **个人访问令牌（PAT）** | `pak_` | 所有机器人 | 多机器人，全权控制 |
**机器人令牌**：在创建机器人时，从 BotBell 应用获取。一个令牌 = 一个机器人。
**PAT**：在 BotBell 应用 > 设置 > API 密钥下创建。一个令牌控制所有机器人。
## 快速开始
### 1. 安装 BotBell 应用
从应用商店下载，创建机器人，并获取您的令牌。
### 2. 安装消息推送服务器
```bash
npm install -g @botbell/mcp-server
```
### 3. 配置 Claude 桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
**选项 A：PAT 模式（推荐）**
```json
{
"mcpServers": {
"botbell": {
"command": "botbell-mcp",
"env": {
"BOTBELL_TOKEN": "pak_您的_pat_在此"
}
}
}
}
```
**选项 B：机器人令牌模式**
```json
{
"mcpServers": {
"botbell": {
"command": "botbell-mcp",
"env": {
"BOTBELL_TOKEN": "bt_您的令牌_在此"
}
}
}
}
```
### 4. 使用它
告诉 Claude：
- "向我的手机发送通知，内容是构建已完成"
- "分析此日志文件并将摘要推送到我的手机"
- "检查我在 BotBell 中是否有回复"
- "列出我的机器人"（PAT 模式）
- "创建一个名为 Deploy Alerts 的新机器人"（PAT 模式）
## 工具
### PAT 模式（`pak_` 令牌）
#### `botbell_list_bots`
列出所有机器人。使用此命令查找 `bot_id` 以便发送。
#### `botbell_create_bot`
创建新机器人。
| 参数 | 必需 | 描述 |
|-----------|----------|-------------|
| 名称 | 是 | 机器人名称（最多 50 个字符） |
| 描述 | 否 | 机器人描述 |
#### `botbell_send`
通过特定机器人发送推送通知。
| 参数 | 必需 | 描述 |
|-----------|----------|-------------|
| bot_id | 是 | 机器人 ID（使用 `botbell_list_bots` 查找） |
| 消息 | 是 | 消息内容（最多 4096 个字符） |
| 标题 | 否 | 通知标题 |
| 网址 | 否 | 要附加的网址（可点击） |
| 图片网址 | 否 | 要附加的图片网址 |
| 操作 | 否 | 快速回复按钮（最多 5 个），参见 [操作](#操作) |
#### `botbell_get_replies`
检查特定机器人的用户回复。
| 参数 | 必需 | 描述 |
|-----------|----------|-------------|
| bot_id | 是 | 要检查的机器人 ID |
| 限制 | 否 | 要获取的最大回复数（默认为 20） |
### 机器人令牌模式（`bt_` 令牌）
#### `botbell_send`
发送推送通知。
| 参数 | 必需 | 描述 |
|-----------|----------|-------------|
| 消息 | 是 | 消息内容（最多 4096 个字符） |
| 标题 | 否 | 通知标题 |
| 网址 | 否 | 要附加的网址（可点击） |
| 图片网址 | 否 | 要附加的图片网址 |
| 操作 | 否 | 快速回复按钮（最多 5 个），参见 [操作](#操作) |
#### `botbell_get_replies`
从 BotBell 应用获取用户回复。
| 参数 | 必需 | 描述 |
|-----------|----------|-------------|
| 限制 | 否 | 要获取的最大回复数（默认为 20） |
## 额外令牌
如果您需要向多个帐户的机器人发送通知，您可以通过 `BOTBELL_EXTRA_TOKENS` 环境变量配置额外的机器人令牌。
格式：`alias1:bt_token1,alias2:bt_token2`
```json
{
"mcpServers": {
"botbell": {
"command": "botbell-mcp",
"env": {
"BOTBELL_TOKEN": "pak_您的_pat_在此",
"BOTBELL_EXTRA_TOKENS": "team-ops:bt_abc123,home:bt_xyz789"
}
}
}
}
```
配置额外令牌后：
- `alias` 参数在 `botbell_send` 和 `botbell_get_replies` 中可用
- 使用 `alias` 通过特定的额外令牌路由消息
- 在 PAT 模式下，`botbell_list_bots` 显示额外机器人以及您自己的机器人
- 如果没有 `alias`，则默认使用主令牌（`BOTBELL_TOKEN`）
## 适用于 Cursor / 其他 MCP 客户端
将以下内容添加到您的 MCP 配置中：
```json
{
"botbell": {
"command": "botbell-mcp",
"env": {
"BOTBELL_TOKEN": "pak_您的_pat_在此"
}
}
}
```
## 操作
为您的通知添加交互式按钮。用户可以点击回复而无需输入。
```json
{
"message": "将 v2.3 部署到生产环境？",
"actions": [
{ "key": "approve", "label": "是" },
{ "key": "reject", "label": "否" },
{ "key": "custom", "label": "其他...", "type": "input", "placeholder": "输入原因" }
]
}
```
| 字段 | 必需 | 描述 |
|-------|----------|-------------|
| 键 | 是 | 用户点击时返回的标识符（最多 64 个字符） |
| 标签 | 是 | 显示给用户的按钮文本（最多 64 个字符） |
| 类型 | 否 | `"button"`（默认）或 `"input"`（打开文本字段） |
| 占位符 | 否 | 输入字段的占位符（最多 128 个字符） |
当用户点击操作时，`botbell_get_replies` 返回 `action` 键以及消息内容：
```
[2026-01-15T10:30:00.000Z] [action:approve] 是
```
## 轻量级替代方案
如果 MCP 超出您的需求：
- **SDK** — 直接从您的代码调用 REST API：
- Python：`pip install botbell`（[PyPI](https://pypi.org/project/botbell/) · [GitHub](https://github.com/qq418716640/botbell-python)）
- JavaScript：`npm install @botbell/sdk`（[npm](https://www.npmjs.com/package/@botbell/sdk) · [GitHub](https://github.com/qq418716640/botbell-js)）
- **代理技能** — 一条命令安装，零依赖，与 30+ AI 工具配合使用：[BotBell 代理技能](https://github.com/qq418716640/botbell-skill)
## 链接
- [BotBell 官网](https://botbell.app)
- [API 文档](https://botbell.app/docs/api)
- [SDK 文档](https://botbell.app/docs/sdk)
- [MCP 设置指南](https://botbell.app/docs/mcp)
- [代理技能指南](https://botbell.app/docs/skill)
