F

ForgingStack Watchtower

ForgingStack Watchtower

本地服务

github.com/jdkabattles云与基础设施05 天前更新

关于 ForgingStack Watchtower

ForgingStack Watchtower 是连接私有存活监控服务的公开 MCP 客户端，供负责人跟踪 Agent 是否按时签到。Agent 逾期未签到时，它会发送邮件提醒，并为提醒和恢复生成哈希链回执。

主要功能

01按间隔和宽限期注册监控
02使用监控 ID 和密钥接收签到
03向负责人发送逾期邮件提醒
04恢复签到后生成恢复回执
05暂停监控并查询状态或回执

适用场景

01监控 Agent 是否持续运行
02Agent 错过签到时段时通知负责人

MCP 相关

它通过 stdio 以 MCP 服务形式运行，并封装私有服务。工具可创建监控、签到、查询监控状态和额度，以及获取回执。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "jdkabattles-forgingstack-watchtower": {
      "command": "uvx",
      "args": [
        "forgingstack-watchtower"
      ],
      "env": {
        "FORGINGSTACK_API_BASE": "<FORGINGSTACK_API_BASE>",
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

启动命令uvx forgingstack-watchtower

需要配置的环境变量

FORGINGSTACK_API_BASEWatchtower API base URL. Live default.

FORGINGSTACK_API_KEY密钥API key for Watchtower. Sign up via POST /v1/signup (key shown once). Required for all tools except check_in, which needs only watch_id and checkin_key.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiforgingstack-watchtower0.1.0stdio

工具

5

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
agent_id	string	是
notify_email	string	是
grace_seconds	integer	是
interval_seconds	integer	是

详细介绍

ForgingStack Watchtower

停止签到的 Agent，才是你会听说的那个。

mcp-name: io.github.jdkabattles/forgingstack-watchtower

这是 Watchtower 的公开客户端。服务本身——存活检查、告警邮件、回执链、密钥存储和计费——均运行在 ForgingStack 的私有服务上，不在此仓库中。复制此仓库并不会让你获得该服务：你仍需通过下方的注册流程获取 API 密钥和额度。

实时 API：https://forgingstack-watchtower.jkbattles.workers.dev

工作原理

为某个 Agent 注册监控项：设置它应多久签到一次（interval_seconds，30 至 2,592,000），以及允许的额外静默时间（grace_seconds，0 至 86,400），并指定接收告警邮件的地址。每位所有者对每个 Agent 只能注册一个监控项。注册监控项需消耗 1 个额度，并会返回一个签到密钥，该密钥只显示一次。
Agent 使用其监控项 ID 和签到密钥进行签到。签到免费且无需 API 密钥。
如果 Agent 超过检查间隔加宽限时间仍未签到，Watchtower 会发送告警邮件并签发哈希链式回执。每次告警会消耗监控项所有者 1 个额度；额度为 0 的所有者会被跳过，监控项仍会保持逾期状态。
Agent 在收到告警或处于逾期状态后重新签到时，会签发一张恢复回执。你也可以将监控项设为暂停（1 至 1,440 分钟），暂时静默告警。

注册（v1）

curl -X POST https://forgingstack-watchtower.jkbattles.workers.dev/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

返回一个 API 密钥**，仅显示一次**，以及 100 个初始额度。请立即保存密钥——系统只存储其哈希，之后无法再次显示。点击注册邮件中的验证链接后，密钥才能用于注册监控项；在此之前，注册监控项会返回 403。

使用方法（MCP，stdio）

设置密钥，然后运行此仓库中的 MCP 服务：

export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server

工具：create_watch、check_in、get_watch、get_credits、get_receipt。何时使用以及何时不使用，请参阅 SKILL.md。

价格

注册监控项需 1 个额度，每次告警需 1 个额度，签到免费。注册时赠送 100 个初始额度。额度包：1,000 个额度售价 $10，通过 POST /v1/billing/checkout 购买——付款验证通过后（通常在一小时内）即会添加额度。

此仓库中的文件

app/mcp_server.py — MCP 封装客户端（stdio，仅使用标准库）
SKILL.md — 何时使用，以及如何读取监控状态
agent-card.json — A2A 风格的发现卡片
server.json — MCP Registry 元数据
pyproject.toml — MCP 客户端的包元数据

评论

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。