Webhooky

webhooky-mcp

一个面向 Webhooky 的 MCP 服务。

为 AI 助手提供一项能力：向你的手机发送推送通知。 当你让它执行耗时任务后离开时，这项能力很有用；它可以自行通知你，而不是编写一段用于通知你的代码。

You:  Run the migration and let me know when it's done.
Claude: [runs it, then calls send_notification]
📱      ✅ Migration done · 14,203 rows · 6m12s

设置

安装 Webhooky 应用（iOS · Android），创建一个端点并复制其 URL。无需账号，应用打开时 URL 就会生成。免费套餐每月提供 100 条通知，最多支持 3 个端点。

Claude Code

claude mcp add webhooky -e WEBHOOKY_URL=https://api.webhooky.app/YOUR_KEY -- npx -y webhooky-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "webhooky": {
      "command": "npx",
      "args": ["-y", "webhooky-mcp"],
      "env": { "WEBHOOKY_URL": "https://api.webhooky.app/YOUR_KEY" }
    }
  }
}

Cursor、Zed 和其他 MCP 客户端

配置格式相同：命令为 npx，参数为 ["-y", "webhooky-mcp"]，并在环境中设置 WEBHOOKY_URL。

工具

send_notification

参数	类型	必填	说明
title	string	是	最多 100 个字符
message	string	否	最多 500 个字符。省略时使用端点中配置的文本
sound	enum	否	40 种声音 ID 之一。省略时使用端点的声音
vibrate	boolean	否	覆盖端点的振动设置

返回确认信息，其中包括通知送达的设备数量。当通知已接受但未送达时（免费套餐的月度配额用尽时就会发生这种情况），它会报告错误，而不是给出令人欣喜的成功提示。Webhooky 在这种情况下会刻意返回 HTTP 200，以免 Stripe 等发送方重试；此服务会为你解析出这一差异。

list_sounds

按含义分组的 40 种声音（金钱、成功、失败、信息、引人注意、趣味），这样助手就能根据事件选择合适的声音，而不必根据 ID 猜测。

配置

变量	必填	默认值	说明
WEBHOOKY_URL	是	（无）	完整的端点 URL，包含密钥
WEBHOOKY_TIMEOUT_MS	否	10000	请求超时时间

WEBHOOKY_URL 必须使用 https，但 localhost / 127.0.0.1 除外；由于数据不会离开本机，这些地址允许使用普通的 http。

关于 URL 的说明

你的端点 URL 只能执行一项操作：在你的手机上触发通知。它无法读取你的历史记录、访问你的账号或泄露任何数据。任何知道它的人都可以向你发送通知，这就是它可能造成的全部影响范围。 因此，此服务只会从环境中读取 URL，绝不会将其作为工具参数：无法诱导模型将通知发送到其他端点，而且密钥不会进入对话。返回错误消息前，也会先移除其中的密钥。

对待 WEBHOOKY_URL 时，可以像对待 Slack 传入 Webhook URL 一样：不要将其放进公开仓库，但它并不是密码。如果 URL 泄露了，请在应用中删除该端点并创建一个新端点。旧 URL 会立即失效。

开发

npm install
npm test     # drives the server over real stdio against a stub endpoint

链接

• 面向 AI Agent 的集成约定
• OpenAPI 3.1 规范
• API 文档

MIT · Aigner Software e.U.