AIアシスタントによるウェブサイトのヘルスモニタリング、DNSおよびSSLチェック、ビジュアルリグレッションやアップタイムモニターの管理を可能にします。
別名 VisualSentinel/mcp-server, mcp-server, @visualsentinel/mcp-server
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.2.3
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
Visual Sentinel MCPとは
AIアシスタントによるウェブサイトのヘルスモニタリング、DNSおよびSSLチェック、ビジュアルリグレッションやアップタイムモニターの管理を可能にします。
プロジェクトのREADMEから生成された概要
Visual Sentinel MCP server について
Visual Sentinelは、アップタイム、パフォーマンス、SSL、DNS、ビジュアルリグレッション、コンテンツの変更を含む6つの異なるレイヤーにわたって、AIアシスタントがウェブサイトのヘルス状態を監視できるMCP serverを提供します。Claude Desktop、Cursor、Cline、ContinueなどのMCP対応クライアントを使用する開発者が、サイトの信頼性に関するタスクを自動化できるように設計されています。このサーバーはstdioを介してローカルで動作し、npxまたはDockerを使用してデプロイできます。
ユーザーは、アカウントなしで5つのパブリックツールにアクセスし、DNS、SSL、およびスピードチェックを実行できます。より高度な管理を行うには、Visual SentinelのアカウントとAPIキーが必要です。認証を行うことで、AIアシスタントはモニターの管理、インシデント履歴の取得、アラートの確認が可能になります。このサーバーには17個のツールと、サーバーが技術的にオンラインであってもページが崩れて見える原因を診断するためのinvestigate_broken_siteのような専用プロンプトが含まれています。
できること
- 1ウェブサイトの接続問題の診断特定のドメインのDNSレコードやSSL証明書の有効性を調査するようアシスタントに依頼します。
- 2稼働中のサイトモニターの管理新しいHTTPSモニターを作成するか、現在オフラインの既存のモニターを一覧表示するようAIに依頼します。
- 3過去のアップタイムとパフォーマンスの分析特定期間におけるランディングページのアップタイム率を計算するようアシスタントに指示します。
- 4サービスインシデントへの対応最近のインシデントを取得し、ユーザーに代わって特定のアラートを確認するようAIに指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Visual Sentinel MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにVisual Sentinel MCPをインストール
$ claude mcp add --env 'VS_API_KEY=<YOUR_VS_API_KEY>' mcp-server -- npx -y @visualsentinel/mcp-serverCursorにVisual Sentinel MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@visualsentinel/mcp-server"
],
"env": {
"VS_API_KEY": "<YOUR_VS_API_KEY>"
}
}
}
}VS CodeにVisual Sentinel MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@visualsentinel/mcp-server"
],
"env": {
"VS_API_KEY": "<YOUR_VS_API_KEY>"
}
}
}
}VS Code CLIにVisual Sentinel MCPをインストール
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@visualsentinel/mcp-server"],"env":{"VS_API_KEY":"<YOUR_VS_API_KEY>"}}'Claude DesktopにVisual Sentinel MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@visualsentinel/mcp-server"
],
"env": {
"VS_API_KEY": "<YOUR_VS_API_KEY>"
}
}
}
}CodexにVisual Sentinel MCPをインストール
$ codex mcp add mcp-server --env 'VS_API_KEY=<YOUR_VS_API_KEY>' -- npx -y @visualsentinel/mcp-serverCodex config.tomlにVisual Sentinel MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@visualsentinel/mcp-server"] [mcp_servers.mcp-server.env] VS_API_KEY = "<YOUR_VS_API_KEY>"
Gemini CLIにVisual Sentinel MCPをインストール
$ gemini mcp add -s user -e 'VS_API_KEY=<YOUR_VS_API_KEY>' mcp-server npx -- -y @visualsentinel/mcp-serverGemini settings.jsonにVisual Sentinel MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@visualsentinel/mcp-server"
],
"env": {
"VS_API_KEY": "<YOUR_VS_API_KEY>"
}
}
}
}設定
VS_API_KEYシークレットVisual Sentinel API key for the twelve account tools (every paid plan, including the 10-day free trial). Create one at https://visualsentinel.com/settings/api-keys. The five public tools work without it.
| 名前 | 説明 | 種類 |
|---|---|---|
| VS_API_KEY | Visual Sentinel API key for the twelve account tools (every paid plan, including the 10-day free trial). Create one at https://visualsentinel.com/settings/api-keys. The five public tools work without it. | シークレット |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るVisual Sentinel MCP Server
Model Context Protocol server for Visual Sentinel. Visual Sentinel catches pages that look broken even when the site is up. It monitors six layers: uptime, performance, SSL, DNS, visual regression, and content change.
Connect Claude Desktop, Claude Code, Cursor, Cline, Continue, or any MCP-compatible client so an AI assistant can run DNS, SSL and speed checks on any site with no account. With a Visual Sentinel account and an API key (every paid plan, including the 10-day free trial) it can also list and create monitors, fetch incident history, and acknowledge alerts on your behalf.
- Homepage and docs: https://visualsentinel.com/mcp
- npm:
@visualsentinel/mcp-server - OpenAPI spec: https://github.com/VisualSentinel/openapi
- API key (every paid plan, including the 10-day free trial): https://visualsentinel.com/settings/api-keys
- Hosted API reference: https://visualsentinel.com/docs
What you get
17 tools spanning the public Visual Sentinel API:
Public tools (no API key required)
| Tool | Endpoint | Purpose |
|---|---|---|
vs_health |
GET /api/health |
Service health probe |
vs_dns_check |
GET /api/tools/dns-check |
Resolve A / AAAA / MX / NS / TXT / CNAME / SOA records |
vs_ssl_check |
GET /api/tools/ssl-check |
Inspect TLS certificate (issuer, validity, SAN list, chain) |
vs_speed_test |
GET /api/tools/speed-test |
One-shot performance check (TTFB, total load, transfer size) |
vs_website_check |
GET /api/tools/website-check |
Quick HTTP health check |
Authenticated tools (require VS_API_KEY)
| Tool | Endpoint | Purpose |
|---|---|---|
vs_monitors_list |
GET /api/monitors |
List monitors with optional status / type filters |
vs_monitors_get |
GET /api/monitors/{id} |
Fetch a single monitor with current status |
vs_monitors_create |
POST /api/monitors |
Create a new monitor |
vs_monitors_check_now |
POST /api/monitors/{id}/check |
Trigger an immediate check |
vs_monitors_uptime |
GET /api/monitors/{id}/uptime |
Uptime percentage for a preset window, a custom date range, or the full history |
vs_monitors_metrics_bulk |
POST /api/monitors/metrics |
Uptime or response-time metrics for up to 100 monitors in one call |
vs_incidents_list |
GET /api/incidents |
List incidents, filterable by status or monitor |
vs_incidents_get |
GET /api/incidents/{id} |
Fetch an incident with full check history |
vs_alerts_list |
GET /api/alerts |
List alerts by status |
vs_alerts_acknowledge |
POST /api/alerts/{id}/acknowledge |
Acknowledge an alert |
vs_status_pages_list |
GET /api/status-pages |
List your public status pages |
vs_servers_list |
GET /api/servers |
List registered origin servers |
Prompts and resources
Besides the 17 tools, the server offers four ready-made prompts and three read-only resources. None of them need an API key except the last prompt.
| Prompt | What it does |
|---|---|
check_website_health |
Runs the website, SSL, DNS and speed checks on one site and summarises what needs attention. |
investigate_broken_site |
Works through DNS, certificate, response and speed to find the layer at fault; reads incidents and alerts too when an API key is set. |
pre_launch_checklist |
Pass, Warn or Fail checklist for a new or migrated domain. |
triage_open_incidents |
Ranks open incidents and unacknowledged alerts (needs an API key). |
| Resource | Contents |
|---|---|
visualsentinel://plans |
Prices, plan limits, the trial terms, and which plans include API keys and the account tools. |
visualsentinel://help |
Setup without an account, adding an API key, links. |
visualsentinel://tools |
Every tool, whether it needs a key, and whether it changes data. |
Without an API key the server still starts and lists everything. The five public tools work; each account tool returns a clear message that it needs an API key (every paid plan, including the 10-day free trial) instead of failing.
Installation
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"visualsentinel": {
"command": "npx",
"args": ["-y", "@visualsentinel/mcp-server"],
"env": {
"VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Restart Claude Desktop. The 17 tools appear under the tools menu.
Claude Code (CLI)
claude mcp add visualsentinel \
-- npx -y @visualsentinel/mcp-server
Then export VS_API_KEY in the shell where Claude Code runs.
Cursor and Grok Bot
This repository is also an installable plugin: .cursor-plugin/plugin.json and mcp.json for the Cursor Marketplace, and .claude-plugin/plugin.json and .mcp.json for Grok and Claude Code (grok plugin install VisualSentinel/mcp-server). Or add the server by hand to ~/.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
The server also ships as a Gemini CLI extension (gemini-extension.json).
Cline (VS Code extension)
In Cline's MCP settings, add:
{
"visualsentinel": {
"command": "npx",
"args": ["-y", "@visualsentinel/mcp-server"],
"env": { "VS_API_KEY": "vs_live_..." }
}
}
Continue
In ~/.continue/config.json:
{
"mcpServers": [
{
"name": "visualsentinel",
"command": "npx",
"args": ["-y", "@visualsentinel/mcp-server"],
"env": { "VS_API_KEY": "vs_live_..." }
}
]
}
Generic MCP client (stdio)
VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server
The server speaks JSON-RPC over stdio per the MCP specification (2025-06-18).
Configuration
Two environment variables, both optional except in the noted cases:
| Variable | Default | Purpose |
|---|---|---|
VS_API_KEY |
(none) | Required for the 12 authenticated tools (API keys come with every paid plan, including during the 10-day free trial). Public tools work without it. Generate at https://visualsentinel.com/settings/api-keys. |
VS_API_BASE |
https://visualsentinel.com |
Override only for testing against a local development instance. |
If a tool that needs auth is called without VS_API_KEY, the server returns a clear error rather than silently failing.
VISUALSENTINEL_API_KEY is accepted as an alias for VS_API_KEY for clients that prefer the longer name.
Usage examples
After installation, ask the AI assistant things like:
- "What's the SSL certificate situation on visualsentinel.com? When does it expire?"
- "List my Visual Sentinel monitors that are currently down."
- "Add a new HTTPS monitor for https://shop.example.com checking every minute."
- "Show me incidents from the last 24 hours and acknowledge the ones for monitor-id
clm123." - "What's the uptime percentage for my landing page over the last 30 days?"
- "Run a speed test on https://example.com/checkout."
The assistant chooses the appropriate tool, fills in arguments from the conversation, and shows the JSON response.
Security notes
- Your API key never leaves the machine running this MCP server. Requests go directly to
https://visualsentinel.comover HTTPS. - Public tools (
vs_health,vs_dns_check,vs_ssl_check,vs_speed_test,vs_website_check) work without an API key, but their results are visible to anyone who can read your conversation logs. Treat them like any other shell-out. - Revoke a leaked API key immediately at https://visualsentinel.com/settings/api-keys. Revocation takes effect within seconds.
- Tools that mutate state (
vs_monitors_create,vs_monitors_check_now,vs_alerts_acknowledge) inherit your API key's role-based permissions. A read-only key cannot create monitors.
Development
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
To smoke-test locally against the production API:
VS_API_KEY=vs_live_... node dist/index.js
The server speaks JSON-RPC on stdin / stdout. Pipe in a tools/list request to see the registered tools.
Versioning
Semantic versioning. Breaking changes to tool names or required arguments get a major bump. Adding new tools or new optional arguments is a minor or patch.
The server's tool surface tracks the public Visual Sentinel API spec at https://github.com/VisualSentinel/openapi. When the upstream API gains a useful endpoint, this repository typically catches up within a release.
License
MIT. See LICENSE.
The Visual Sentinel API service itself is governed by https://visualsentinel.com/terms.
Visual Sentinel MCPのよくある質問
Visual Sentinel MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'VS_API_KEY=<YOUR_VS_API_KEY>' mcp-server -- npx -y @visualsentinel/mcp-serverを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Visual Sentinel MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
サーバーを使用するためにアカウントは必要ですか?
いいえ、パブリックツールを使用すれば、アカウントなしで任意のサイトに対してDNS、SSL、およびスピードチェックを実行できます。
どのツールにAPIキーが必要ですか?
モニターの作成、インシデントの一覧表示、アラートの確認などの認証が必要なツールには、VS_API_KEYが必要です。これはすべての有料プランおよび10日間の無料トライアルで利用可能です。
APIキーのセキュリティは確保されていますか?
はい、APIキーがMCP serverを実行しているマシンから外部に出ることはありません。リクエストはHTTPS経由でサービスに直接送信されます。