Visual Sentinel

Visual Sentinel MCP Server

适用于 Visual Sentinel 的 Model Context Protocol 服务。即使网站仍在运行，Visual Sentinel 也能发现页面异常。它会监控六个层面：正常运行时间、性能、SSL、DNS、视觉回归和内容变更。

连接 Claude Desktop、Claude Code、Cursor、Cline、Continue 或任何兼容 MCP 的客户端，即可让 AI 助手在任何网站上运行 DNS、SSL 和速度检查，无需账户。使用 Visual Sentinel 账户和 API 密钥（Business 和 Agency 计划）后，还可以代表你列出和创建监控项、获取事件历史记录并确认警报。

• 主页和文档： https://visualsentinel.com/mcp
• npm： @visualsentinel/mcp-server
• OpenAPI 规范： https://github.com/VisualSentinel/openapi
• API 密钥（Business 和 Agency 计划）： https://visualsentinel.com/settings/api-keys
• 托管的 API 参考： https://visualsentinel.com/docs

你将获得

覆盖 Visual Sentinel 公共 API 的 17 个工具：

公共工具（无需 API 密钥）

工具	端点	用途
vs_health	GET /api/health	服务健康状态探测
vs_dns_check	GET /api/tools/dns-check	解析 A / AAAA / MX / NS / TXT / CNAME / SOA 记录
vs_ssl_check	GET /api/tools/ssl-check	检查 TLS 证书（颁发者、有效期、SAN 列表、证书链）
vs_speed_test	GET /api/tools/speed-test	单次性能检查（TTFB、总加载时间、传输大小）
vs_website_check	GET /api/tools/website-check	快速 HTTP 健康检查

需验证身份的工具（需要 VS_API_KEY）

工具	端点	用途
vs_monitors_list	GET /api/monitors	列出监控项，可按状态 / 类型筛选
vs_monitors_get	GET /api/monitors/{id}	获取单个监控项及其当前状态
vs_monitors_create	POST /api/monitors	创建新的监控项
vs_monitors_check_now	POST /api/monitors/{id}/check	立即触发检查
vs_monitors_uptime	GET /api/monitors/{id}/uptime	获取预设时间窗口、自定义日期范围或完整历史记录的正常运行时间百分比
vs_monitors_metrics_bulk	POST /api/monitors/metrics	一次调用获取最多 100 个监控项的正常运行时间或响应时间指标
vs_incidents_list	GET /api/incidents	列出事件，可按状态或监控项筛选
vs_incidents_get	GET /api/incidents/{id}	获取事件及完整检查历史记录
vs_alerts_list	GET /api/alerts	按状态列出警报
vs_alerts_acknowledge	POST /api/alerts/{id}/acknowledge	确认警报
vs_status_pages_list	GET /api/status-pages	列出你的公开状态页面
vs_servers_list	GET /api/servers	列出已注册的源服务器

提示词和资源

除 17 个工具外，该服务还提供 4 个现成提示词和 3 个只读资源。除最后一个提示词外，它们都不需要 API 密钥。

提示词	功能
check_website_health	对一个网站运行网站、SSL、DNS 和速度检查，并总结需要关注的问题。
investigate_broken_site	依次检查 DNS、证书、响应和速度，以找出故障所在层；设置 API 密钥后，还会读取事件和警报。
pre_launch_checklist	针对新域名或迁移后的域名提供通过、警告或失败检查清单。
triage_open_incidents	对未解决的事件和未确认的警报进行排序（需要 API 密钥）。

资源	内容
visualsentinel://plans	套餐限制，以及哪些套餐包含 API 密钥和账户工具。
visualsentinel://help	无需账户即可进行的设置、添加 API 密钥的方式和相关链接。
visualsentinel://tools	每个工具、是否需要密钥，以及是否会更改数据。

即使没有 API 密钥，该服务仍会启动并列出所有内容。5 个公开工具可正常使用；每个账户工具都会清楚提示需要 API 密钥（Business 和 Agency 套餐），而不会直接失败。

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "visualsentinel": {
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": {
        "VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop。17 个工具会显示在工具菜单中。

Claude Code（CLI）

claude mcp add visualsentinel \
  -- npx -y @visualsentinel/mcp-server

然后在运行 Claude Code 的 shell 中导出 VS_API_KEY。

Cursor 和 Grok Bot

此仓库也可作为插件安装：.cursor-plugin/plugin.json 和 mcp.json 用于 Cursor Marketplace，.claude-plugin/plugin.json 和 .mcp.json 用于 Grok 和 Claude Code（grok plugin install VisualSentinel/mcp-server）。也可以手动将服务添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "visualsentinel": {
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"]
    }
  }
}

Docker

docker build -t visualsentinel-mcp-server .
docker run -i --rm -e VS_API_KEY visualsentinel-mcp-server

该服务还作为 Gemini CLI 扩展提供（gemini-extension.json）。

Cline（VS Code 扩展）

在 Cline 的 MCP 设置中添加：

{
  "visualsentinel": {
    "command": "npx",
    "args": ["-y", "@visualsentinel/mcp-server"],
    "env": { "VS_API_KEY": "vs_live_..." }
  }
}

Continue

在 ~/.continue/config.json 中：

{
  "mcpServers": [
    {
      "name": "visualsentinel",
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": { "VS_API_KEY": "vs_live_..." }
    }
  ]
}

通用 MCP 客户端（stdio）

VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server

该服务按照 MCP 规范（2025-06-18）通过 stdio 使用 JSON-RPC 通信。

配置

有两个可选环境变量，除特别说明的情况外均为可选：

变量	默认值	用途
VS_API_KEY	（无）	12 个需要身份验证的工具必需（Business 和 Agency 套餐提供 API 密钥）。公开工具无需此密钥即可使用。在 https://visualsentinel.com/settings/api-keys 生成。
VS_API_BASE	https://visualsentinel.com	仅用于针对本地开发实例进行测试时覆盖。

如果在未设置 VS_API_KEY 的情况下调用需要身份验证的工具，服务会返回明确的错误，而不会静默失败。

对于偏好使用较长名称的客户端，也可使用 VISUALSENTINEL_API_KEY 作为 VS_API_KEY 的别名。

使用示例

安装后，可以向 AI 助手询问：

• “visualsentinel.com 的 SSL 证书情况如何？什么时候到期？”
• “列出我当前宕机的 Visual Sentinel 监控项。”
• “为 https://shop.example.com 添加一个新的 HTTPS 监控项，每分钟检查一次。”
• “显示过去 24 小时的事件，并确认 monitor-id clm123 的相关事件。”
• “我的落地页过去 30 天的正常运行时间百分比是多少？”
• “对 https://example.com/checkout 运行速度测试。”

助手会选择合适的工具，根据对话填写参数，并显示 JSON 响应。

安全注意事项

• 你的 API 密钥不会离开运行此 MCP 服务的机器。请求会通过 HTTPS 直接发送至 https://visualsentinel.com。
• 公共工具（vs_health、vs_dns_check、vs_ssl_check、vs_speed_test、vs_website_check）无需 API 密钥即可使用，但任何能读取你的对话日志的人都能看到其结果。请像对待其他任何 shell 命令输出一样谨慎处理。
• 如果 API 密钥泄露，请立即在 https://visualsentinel.com/settings/api-keys 撤销。撤销会在几秒内生效。
• 会修改状态的工具（vs_monitors_create、vs_monitors_check_now、vs_alerts_acknowledge）遵循你的 API 密钥的基于角色的权限。只读密钥无法创建监控项。

开发

git clone https://github.com/VisualSentinel/mcp-server.git
cd mcp-server
npm install
npm run build      # tsup, output to dist/
npm run lint       # tsc --noEmit
npm run dev        # tsup --watch

如需针对生产 API 在本地进行冒烟测试：

VS_API_KEY=vs_live_... node dist/index.js

此服务通过标准输入 / 标准输出使用 JSON-RPC。输入 tools/list 请求，即可查看已注册的工具。

版本控制

遵循语义化版本控制。对工具名称或必需参数的破坏性更改会提升主版本号。添加新工具或新的可选参数属于次要版本或补丁版本更新。

此服务提供的工具与 Visual Sentinel 公共 API 规范保持同步，规范地址为 https://github.com/VisualSentinel/openapi。上游 API 新增实用端点后，此仓库通常会在一个版本周期内跟进。

许可证

MIT。请参阅 LICENSE。

Visual Sentinel API 服务本身受 https://visualsentinel.com/terms 约束。