使用说明
@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密钥。
托管安装程序
无需安装。直接连接到 mcp.pingfyr.com 使用HTTP传输。您的API密钥将按每个请求作为承载令牌发送。
{
"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或谷歌日历安排新的提醒 |
list_reminders |
列出所有提醒,并可选择按状态、限制和偏移进行筛选 |
update_reminder |
更新待定提醒(标题、正文、fire_at、频道、收件人、重复、时区) |
cancel_reminder |
取消待处理的提醒 |
create_reminder 参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
title |
是 | 字符串 | 提醒的标题(最多200个字符) |
fire_at |
Yes | string | 何时触发(ISO 8601日期时间,必须在将来) |
channel |
是 | 枚举 | email, webhook, slack, discord, telegram, openclaw, google_calendar |
recipients |
Yes | string[] | 传送地址(有关每个通道的格式,请参阅通道表) |
body |
无 | 字符串 | 提醒的正文/描述(最多2000个字符) |
repeat |
否 | 枚举 | daily, weekly, monthly, custom |
cron_expression |
无 | 字符串 | Cron表达式(当 repeat 是 custom) |
timezone |
无 | string | IANA时区用于定期提醒(默认:UTC) |
metadata |
无 | 对象 | 要附加到提醒的任意键值元数据 |
list_reminders 参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
status |
否 | 枚举 | pending, processing, delivered, failed, cancelled |
limit |
否 | 编号 | 最大结果(默认值:50,最大值:100) |
offset |
无 | 编号 | 分页偏移量(默认值:0) |
update_reminder 参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
id |
是 | 字符串 | 要更新的提醒的UUID |
title |
否 | 字符串 | 新标题 |
body |
否 | 字符串 | 新正文 |
fire_at |
否 | 字符串 | 新的点火时间(ISO 8601) |
channel |
否 | 枚举 | 新通道 |
recipients |
否 | string[] | 已更新的投递地址 |
repeat |
否 | 枚举 | 新的重复计划(空删除) |
timezone |
否 | 字符串 | 新时区 |
例子
电子邮件提醒(多收件人)
{
"title": "Project deadline reminder",
"fire_at": "2026-12-15T08:00:00Z",
"channel": "email",
"recipients": ["alice@example.com", "bob@example.com"]
}
松弛提醒
{
"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"
}
不一致通知
{
"title": "Deploy notification",
"fire_at": "2026-12-01T17:00:00Z",
"channel": "discord",
"recipients": ["https://discord.com/api/webhooks/xxx/yyy"]
}
电报提醒
{
"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"
}
找到你的 bot_id 在设置中→ Pingfyr仪表板上的Telegram机器人。
OpenClaw通知
{
"title": "Agent task complete",
"fire_at": "2026-12-01T10:00:00Z",
"channel": "openclaw",
"recipients": ["https://openclaw.example.com/webhook"]
}
谷歌日历活动(需要Starter+计划)
在用户连接的Google帐户上创建Google日历事件。 在设置中连接您的帐户→ Pingfyr仪表板中的谷歌日历。
{
"title": "Team sync",
"fire_at": "2026-12-01T09:00:00Z",
"channel": "google_calendar",
"recipients": ["google"]
}
Webhook(代理唤醒)
{
"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请求 |
slack |
Slack传入Webhook URL | 将消息发布到Slack频道 |
discord |
Discord Webhook URL | 将消息发布到Discord频道 |
telegram |
bot:<bot_id>:<chat_id> |
通过Telegram机器人发送消息(在设置中注册机器人→ 电报机器人) |
openclaw |
OpenClaw URL | 对OpenClaw端点的POST请求 |
google_calendar |
google (字面意思) |
在您连接的帐户上创建一个谷歌日历事件(需要Starter+计划) |
计划
| 计划 | 价格 | 提醒/月 | 收件人/月 |
|---|---|---|---|
| 免费 | 0美元 | 50美元 | 100美元 |
| 起步价 | 59美元/月 | 10000 | 20000 |
| 专业 | 每月269美元 | 50000 | 100000 |
| 企业 | 联系 | 无限 | 无限 |
免费计划包括Webhook、Slack、Discord、Telegram和OpenClaw频道。电子邮件和谷歌日历需要付费计划(Starter+)。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
PINGFYR_API_KEY |
是 | 您的Pingfyr API密钥 |
PINGFYR_API_URL |
没有 | API基本URL(默认值: https://pingfyr.com) |
许可证
麻省理工学院