Pingfyr

@pingfyr/mcp

通过 MCP 将 AI 助手连接到 Pingfyr。通过自然对话管理提醒。

一次 API 调用。七种渠道。提醒会自动触发——无需外部 cron、轮询或人工照看。

可作为本地 npm 包使用，也可使用托管在 mcp.pingfyr.com 的服务——无需本地安装。

安装

npm install -g @pingfyr/mcp

或通过 npx 直接运行：

npx @pingfyr/mcp

配置

本地设置（stdio）

将 MCP 服务作为本地进程运行。需要 Node.js 18+。

添加到 MCP 客户端配置中（Claude Code、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "pingfyr": {
      "command": "pingfyr-mcp",
      "env": {
        "PINGFYR_API_KEY": "rm_your_api_key"
      }
    }
  }
}

在 pingfyr.com 注册以获取 API 密钥。

托管设置

无需安装。使用 HTTP 传输直接连接到 mcp.pingfyr.com。每次请求都会将 API 密钥作为 Bearer token 发送。

{
  "mcpServers": {
    "pingfyr": {
      "type": "http",
      "url": "https://mcp.pingfyr.com",
      "headers": {
        "Authorization": "Bearer rm_your_api_key"
      }
    }
  }
}

Claude Code 和 Cursor 支持 HTTP 传输。Claude Desktop 需要使用上面的本地（stdio）选项。

可用工具

工具	说明
create_reminder	通过电子邮件、webhook、Slack、Discord、Telegram、OpenClaw 或 Google Calendar 安排新提醒
list_reminders	列出所有提醒，可按状态筛选并设置数量上限和偏移量
update_reminder	更新待处理的提醒（标题、正文、fire_at、渠道、收件人、重复频率、时区）
cancel_reminder	取消待处理的提醒

create_reminder 参数

参数	必填	类型	说明
title	是	string	提醒标题（最多 200 个字符）
fire_at	是	string	触发时间（ISO 8601 日期时间，必须为未来时间）
channel	是	enum	email、webhook、slack、discord、telegram、openclaw、google_calendar
recipients	是	string[]	投递地址（各渠道的格式请参见 Channels 表）
body	否	string	提醒正文/描述（最多 2000 个字符）
repeat	否	enum	daily、weekly、monthly、custom
cron_expression	否	string	Cron 表达式（当 repeat 为 custom 时必填）
timezone	否	string	重复提醒所用的 IANA 时区（默认值：UTC）
metadata	否	object	附加到提醒的任意键值元数据

list_reminders 参数

参数	必填	类型	说明
status	否	enum	pending、processing、delivered、failed、cancelled
limit	否	number	结果数量上限（默认值：50，最大值：100）
offset	否	number	分页偏移量（默认值：0）

update_reminder 参数

参数	必填	类型	描述
id	是	string	要更新的提醒的 UUID
title	否	string	新标题
body	否	string	新正文
fire_at	否	string	新触发时间（ISO 8601）
channel	否	enum	新渠道
recipients	否	string[]	更新后的投递地址
repeat	否	enum	新重复计划（设为 null 可移除）
timezone	否	string	新时区

示例

电子邮件提醒（多收件人）

{
  "title": "Project deadline reminder",
  "fire_at": "2026-12-15T08:00:00Z",
  "channel": "email",
  "recipients": ["[email protected]", "[email protected]"]
}

Slack 提醒

{
  "title": "Weekly team sync reminder",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "slack",
  "recipients": ["https://hooks.slack.com/services/T.../B.../xxx"],
  "repeat": "weekly",
  "timezone": "America/New_York"
}

Discord 通知

{
  "title": "Deploy notification",
  "fire_at": "2026-12-01T17:00:00Z",
  "channel": "discord",
  "recipients": ["https://discord.com/api/webhooks/xxx/yyy"]
}

Telegram 提醒

{
  "title": "Daily standup",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "telegram",
  "recipients": ["bot:your-bot-uuid:your-chat-id"],
  "repeat": "daily",
  "timezone": "Europe/Berlin"
}

在 Pingfyr 控制面板的 Settings → Telegram Bots 中查找你的 bot_id。

OpenClaw 通知

{
  "title": "Agent task complete",
  "fire_at": "2026-12-01T10:00:00Z",
  "channel": "openclaw",
  "recipients": ["https://openclaw.example.com/webhook"]
}

Google Calendar 日程（需要 Starter+ 计划）

在用户已连接的 Google 账号中创建 Google Calendar 日程。 在 Pingfyr 控制面板的 Settings → Google Calendar 中连接你的账号。

{
  "title": "Team sync",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "google_calendar",
  "recipients": ["google"]
}

Webhook（唤醒 Agent）

{
  "title": "Check for new orders",
  "fire_at": "2026-12-01T10:00:00Z",
  "channel": "webhook",
  "recipients": ["https://your-agent.example.com/webhook"],
  "repeat": "daily"
}

自定义 cron 计划

{
  "title": "Weekday morning check",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "webhook",
  "recipients": ["https://your-agent.example.com/webhook"],
  "repeat": "custom",
  "cron_expression": "0 9 * * MON-FRI",
  "timezone": "America/New_York"
}

渠道

渠道	recipients 格式	描述
email	电子邮件地址	投递到一个或多个电子邮箱（需要 Starter+ 计划）
webhook	HTTP/HTTPS URL	发送 POST 请求以唤醒 Agent
slack	Slack Incoming Webhook URL	向 Slack 频道发送消息
discord	Discord Webhook URL	向 Discord 频道发送消息
telegram	bot:<bot_id>:<chat_id>	通过 Telegram 机器人发送消息（在 Settings → Telegram Bots 中注册机器人）
openclaw	OpenClaw URL	向 OpenClaw 端点发送 POST 请求
google_calendar	google（固定值）	在已连接的账号中创建 Google Calendar 日程（需要 Starter+ 计划）

计划

计划	价格	每月提醒数	每月收件人数
Free	$0	50	100
Starter	$59/mo	10,000	20,000
Pro	$269/mo	50,000	100,000
Enterprise	联系我们	无限	无限

Free 计划包含 Webhook、Slack、Discord、Telegram 和 OpenClaw 渠道。电子邮件和 Google Calendar 需要付费计划（Starter+）。

环境变量

变量	必填	描述
PINGFYR_API_KEY	是	你的 Pingfyr API 密钥
PINGFYR_API_URL	否	API 基础 URL（默认值：https://pingfyr.com）

许可证

MIT