Visual Sentinel MCP 服务器

用于 Visual Sentinel 的模型上下文协议 (MCP) 服务器，这是一个六层网站监控平台：正常运行时间、性能、SSL、DNS、视觉回归和内容变更检测。

将 Claude Desktop、Claude Code、Cline、Continue 或任何兼容 MCP 的客户端连接到您的 Visual Sentinel 账户，以便 AI 助手可以代表您列出监控器、创建监控器、获取事件历史记录、运行免费的 DNS / SSL / 速度检查，并确认警报。

• npm: @visualsentinel/mcp-server

• OpenAPI 规范: https://github.com/VisualSentinel/openapi

• 获取 API 密钥: https://visualsentinel.com/settings/api-keys

• 托管 API 参考: https://visualsentinel.com/docs

您将获得什么

涵盖公共 Visual Sentinel API 的 16 个工具：

公共工具（无需 API 密钥）

已认证工具（需要 VS_API_KEY）

安装

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。16 个工具将出现在工具菜单下。

Claude Code (CLI)

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

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

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，服务器将返回明确的错误，而不是静默失败。

VISUALSENTINEL_API_KEY 被接受为 VS_API_KEY 的别名，适用于偏好较长名称的客户端。

使用示例

安装后，您可以向 AI 助手询问如下内容：

• “visualsentinel.com 的 SSL 证书情况如何？它什么时候过期？”

• “列出我当前已宕机的 Visual Sentinel 监控器。”

• “为 https://shop.example.com 添加一个新的 HTTPS 监控器，每分钟检查一次。”

• “向我展示过去 24 小时的事件，并确认监控器 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

服务器在 stdin / stdout 上使用 JSON-RPC 进行通信。通过管道输入 tools/list 请求以查看已注册的工具。

版本控制

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

服务器的工具界面跟踪 https://github.com/VisualSentinel/openapi 上的公共 Visual Sentinel API 规范。当上游 API 获得有用的端点时，此存储库通常会在一个版本内跟进。

许可证

MIT。请参阅 LICENSE。

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