关于 AyeWatch
AyeWatch MCP 提供管理主题和网页监控器及其告警 Webhook 的工具。它将助手连接到 AyeWatch 托管的监控服务;告警通过通知或配置的 Webhook 接收。
主要功能
- 01列出、查看、创建、更新和删除监控器
- 02暂停或恢复监控计划
- 03查看并配置告警 Webhook
- 04轮换 Webhook 签名密钥
适用场景
- 01检查启用和已暂停的监控器
- 02设置每日主题监控
- 03不再需要跟踪时暂停监控器
- 04将告警发送到自定义 HTTPS 端点
MCP 相关
托管的 Streamable HTTP 服务提供监控器和 Webhook 管理工具。Webhook 工具需要 API 密钥;MCP 不返回告警历史。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://ayewatch.ai/api/mcpclaude mcp add --transport http srx9-ayewatch https://ayewatch.ai/api/mcp{"mcpServers":{"srx9-ayewatch":{"type":"http","url":"https://ayewatch.ai/api/mcp"}}}在 Cursor 中打开{"servers":{"srx9-ayewatch":{"type":"http","url":"https://ayewatch.ai/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"srx9-ayewatch":{"type":"http","url":"https://ayewatch.ai/api/mcp"}}}{"mcpServers":{"srx9-ayewatch":{"serverUrl":"https://ayewatch.ai/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://ayewatch.ai/api/mcp需要授权工具
详细介绍
AyeWatch MCP
将 AI 助手连接到 AyeWatch,它会监控主题和网页,并在内容发生变化或符合你的关注条件时向你发送提醒。本仓库包含 AyeWatch MCP 服务的连接详情和列表文件。服务本身由 AyeWatch 托管。
- 端点:
https://ayewatch.ai/api/mcp - 传输方式: Streamable HTTP,无状态,无会话 ID
- 完整文档: https://ayewatch.ai/documentation/mcp
你可以做什么
| 工具 | 功能 |
|---|---|
list_topics | 列出你的监控项,并按启用状态、间隔和创建日期筛选 |
get_topic | 按 ID 获取一项监控 |
create_topic | 根据主题、一个或多个网页 URL 或模板创建监控 |
update_topic | 更改监控的字段,包括暂停或恢复监控 |
delete_topic | 永久删除监控及其计划 |
get_webhook | 获取你的 webhook URL,以及是否已启用投递 |
set_webhook | 创建 webhook、更改其 URL,或暂停和恢复投递 |
rotate_webhook_secret | 更换 webhook 签名密钥 |
这些工具用于管理你自己账户中的监控项和 webhook,不会返回提醒历史记录。只有使用 API 密钥连接时才能使用 webhook 工具,OAuth 连接不支持,因为 webhook 会接收每一条提醒,而签名密钥用于为提醒签名。
提示词示例:
- “列出我的 AyeWatch 监控项,并告诉我哪些已暂停。”
- “创建一个每日运行的 AyeWatch 监控,追踪固态电池相关新闻。”
- “暂停我关于 iPhone 发布的 AyeWatch 监控。”
- “将我的 AyeWatch 提醒发送到 https://example.com/hooks/ayewatch。”
提醒和 webhook
提醒不会通过 MCP 返回,而是通过 AyeWatch 通知或 webhook 送达。当监控发现新内容时,AyeWatch 会向你运行的 HTTPS 端点发送一个包含 JSON 正文的 POST 请求,其中包含主题 ID、标题和更新内容。
使用 set_webhook 工具、REST API(PUT https://ayewatch.ai/api/v1/webhook)或通知设置设置该端点。AyeWatch 会使用密钥为每次投递签名,并将签名放在 X-AyeWatch-Signature 标头中。MCP 工具不会返回该密钥,因此它不会出现在 AI 对话中;你可以在通知设置中或通过 GET https://ayewatch.ai/api/v1/webhook 查看密钥。每当 webhook URL 被设置或更改时,AyeWatch 也会向你发送电子邮件。如果这不是你进行的更改,请撤销 API 密钥并轮换密钥。负载字段、超时和重试行为详见 webhook 文档。该 URL 属于你,而非 AyeWatch,因此不包含在 MCP 连接文件中。
要求
- 需要拥有 AyeWatch 付费计划账户。所有付费计划均包含 API 和 MCP 访问权限。
- 监控项运行检查时会使用计划额度。
- 默认情况下,每个 API 密钥每分钟最多可发送 120 个请求。
连接
Claude Code
从本仓库安装插件。启用插件时,Claude Code 会提示你输入 API 密钥,并将其保存在系统的安全凭据存储中。
claude plugin marketplace add SRX9/ayewatch-mcp
claude plugin install ayewatch@ayewatch
或者,不使用插件,直接添加服务:
claude mcp add --transport http ayewatch https://ayewatch.ai/api/mcp \
--header "Authorization: Bearer aw_live_YOUR_API_KEY"
Cursor
如果你从 Cursor Marketplace 安装 AyeWatch 插件,请在 Cursor 提示配置插件时设置 AYEWATCH_API_KEY。否则,将以下内容添加到 MCP 配置文件(~/.cursor/mcp.json)中:
{
"mcpServers": {
"ayewatch": {
"url": "https://ayewatch.ai/api/mcp",
"headers": { "Authorization": "Bearer aw_live_YOUR_API_KEY" }
}
}
}
VS Code
将以下内容添加到 .vscode/mcp.json。服务启动时,VS Code 会提示你输入密钥,并且不会将密钥存储在文件中。
{
"inputs": [
{ "type": "promptString", "id": "ayewatch-key", "description": "AyeWatch API key", "password": true }
],
"servers": {
"ayewatch": {
"type": "http",
"url": "https://ayewatch.ai/api/mcp",
"headers": { "Authorization": "Bearer ${input:ayewatch-key}" }
}
}
}
Codex
将以下内容添加到 ~/.codex/config.toml:
[mcp_servers.ayewatch]
url = "https://ayewatch.ai/api/mcp"
http_headers = { "Authorization" = "Bearer aw_live_YOUR_API_KEY" }
其他 MCP 客户端
使用上面的端点,通过 Streamable HTTP 传输方式,并在每个请求中发送 Authorization: Bearer aw_live_YOUR_API_KEY。
在 API 访问设置中创建 API 密钥。请妥善保管,切勿将其提交到代码仓库中。
使用 OAuth 登录
已注册的应用可以提供 AyeWatch 登录,而不是使用 API 密钥。你可以先查看请求的访问权限(读取,或读取和写入),再选择“允许访问”。访问权限会在 30 天后过期,如果你断开连接,则会提前过期。OAuth 令牌仅适用于 MCP 端点。
若要结束应用的访问权限,请打开已连接的应用,然后选择“断开连接”。现有监控会保留其计划,应用已保存的副本也不会被删除。
此仓库包含的内容
| 路径 | 用途 |
|---|---|
server.json | 在官方 MCP 注册表中的条目 |
.claude-plugin/plugin.json、.mcp.json | Claude Code 插件,使用你的 API 密钥连接到托管服务 |
.claude-plugin/marketplace.json | 允许 Claude Code 从此仓库安装插件 |
.cursor-plugin/plugin.json、mcp.json | Cursor 插件,使用你在 Cursor 中设置的 AYEWATCH_API_KEY 连接到托管服务 |
glama.json | 为此仓库认领 Glama 列表条目 |
SUBMISSIONS.md | AyeWatch 所在的目录,以及如何向各目录提交 |
assets/ | 图标和徽标 |
此仓库中的任何内容都不会在你的计算机上运行代码。插件文件只会指示客户端连接到 https://ayewatch.ai/api/mcp,并在 Authorization 标头中向其发送你的 API 密钥。AyeWatch 会收到助手发出的工具调用,例如监控的主题、URL 和计划,但不会收到你计算机上的其他任何内容。
支持与政策
许可证
MIT。此许可证适用于此仓库中的文件,不适用于 AyeWatch 服务。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。