Pingstack

Pingstack MCP 服务

Pingstack 通过心跳检查监控 cron 作业和计划任务，并检查网站、TCP 端口、DNS 记录、SSL 证书和域名到期情况。它的 MCP 服务可让你的编码 Agent 为你设置监控并读取结果。

让你的 Agent 为刚刚编写的备份作业添加心跳检查，并设置正确的 cron 计划、时区和宽限期。询问上周哪些检查发生过事故，以及它们停机了多久。询问你的 API 在过去 30 天内的 p95 延迟。

此存储库包含托管服务的配置文件和目录列表。服务本身运行在 Pingstack 上，因此无需在本地安装或运行任何内容。

端点	https://app.pingstack.io/mcp
传输方式	Streamable HTTP（无状态，JSON 响应）
登录	在浏览器中通过 OAuth 登录，或使用 API 密钥
价格	免费提供 15 项检查。所有套餐均包含 MCP
文档	docs.pingstack.io/mcp

连接

你需要一个 Pingstack 账户。免费注册，然后将此服务添加到你的客户端。不要填写任何 Authorization 标头：客户端会打开浏览器，由 Owner 或 Admin 选择 Pingstack 账户，然后你批准连接。客户端会自行注册，因此无需复制客户端 ID 或密钥。

Claude Code

claude mcp add --transport http pingstack https://app.pingstack.io/mcp

然后运行 /mcp，选择 pingstack 并登录。添加 --scope user，即可在每个项目中使用。你也可以将其安装为插件：

/plugin marketplace add atomicvan/pingstack-mcp
/plugin install pingstack@pingstack

Claude（claude.ai 和 Claude Desktop）

前往“设置”→“连接器”，选择 添加自定义连接器，将其命名为 Pingstack，并输入 https://app.pingstack.io/mcp。

GitHub Copilot CLI

copilot mcp add --transport http pingstack https://app.pingstack.io/mcp

如果 /mcp 显示 needs-auth，请运行 /mcp auth pingstack。

使用 Copilot 的 VS Code

在命令面板中运行 MCP: Add Server，选择 HTTP 并输入 URL。或者将其添加到 .vscode/mcp.json：

{
  "servers": {
    "pingstack": {
      "type": "http",
      "url": "https://app.pingstack.io/mcp"
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json，然后在 Cursor 的 MCP 设置中登录：

{
  "mcpServers": {
    "pingstack": {
      "url": "https://app.pingstack.io/mcp"
    }
  }
}

OpenAI Codex

codex mcp add pingstack --url https://app.pingstack.io/mcp
codex mcp login pingstack

Google Antigravity

使用 Antigravity CLI 将插件安装到 antigravity 文件夹中。应用也会自动识别该插件。首次连接时，你需要在浏览器中登录：

git clone https://github.com/atomicvan/pingstack-mcp
agy plugin install ./pingstack-mcp/antigravity

或者将以下内容添加到 ~/.gemini/config/mcp_config.json，然后在“Agent 设置”→“自定义”下的 pingstack 旁点击 Authenticate：

{
  "mcpServers": {
    "pingstack": {
      "serverUrl": "https://app.pingstack.io/mcp"
    }
  }
}

Gemini CLI

将其安装为扩展：

gemini extensions install https://github.com/atomicvan/pingstack-mcp

然后运行 /mcp auth pingstack。

客户端设置指南详细介绍了各个客户端，还介绍了当客户端无法通过浏览器登录时如何使用 API 密钥。

工具

该服务有 20 个工具。客户端只能看到当前连接有权访问的工具。

工具	功能
get_account_capabilities	账户、套餐限制、用量、时区，以及各类检查所接受的字段
list_checks	列出并筛选检查
get_check	某项检查的设置、状态、上次运行时间和到期日期
create_check	创建心跳、网站、TCP、DNS、SSL 证书或域名检查
update_check	更改检查设置
get_check_ping_urls	心跳检查的 ping URL（需要单独授权，默认关闭）
get_check_history	最长一年的每日运行记录、延迟和事件
list_check_runs	最长 90 天内的单次运行记录
get_check_metrics	按探测区域或 DNS 解析器划分的延迟百分位数
get_check_uptime	过去 7 天至 1 年的正常运行时间
list_incidents	事件，可按检查和状态筛选
get_incident	某个事件
list_notification_groups	可用于接收检查告警的告警组
list_dashboards	仪表板和状态页
get_dashboard	某个仪表板及其检查
create_dashboard	创建私有仪表板
update_dashboard	更改私有仪表板
attach_check_to_dashboard	将检查添加到仪表板
detach_check_from_dashboard	从仪表板移除检查
reorder_dashboard_checks	调整仪表板中检查的顺序

历史记录的保留时长取决于你的套餐。每个参数的详情请参阅 工具参考。

它不能做什么

该服务不能删除任何内容、发布状态页、管理自定义域名、暂停检查、发布事件更新或购买任何内容。这些操作需在 Pingstack 应用中完成。每个连接仅限访问一个账户，并受连接时批准的权限以及批准者当前角色的限制。达到套餐上限时，它会告知你的 Agent 上限，并返回一个供用户打开的升级链接。

心跳 ping URL 允许任何人报告任务已完成，因此只有在连接时勾选相应权限后，服务才会返回这些 URL。

示例提示词

• 为备份任务添加一个每日心跳，宽限期设为 15 分钟，并将其放到 Infrastructure 仪表板上。
• 过去 7 天内哪些检查发生了事件？它们分别中断了多久？
• 为本 README 中的每个域名创建网站和 SSL 证书检查。
• API 检查过去 30 天的 p95 延迟是多少？
• 我的套餐还可以创建多少项检查？

支持

• 文档：docs.pingstack.io
• 电子邮件：[email protected]
• 隐私政策：pingstack.io/privacy-policy
• 条款：pingstack.io/terms-conditions

请将安全问题报告至 [email protected]，而不要公开提交问题。

许可证

此仓库中的文件遵循 MIT 许可证。Pingstack 服务受其条款约束。