Visual Sentinel

Visual Sentinel MCP Server

Visual Sentinel 向けの Model Context Protocol サーバーです。Visual Sentinel は、サイトが稼働していても表示が崩れているページを検知します。稼働状況、パフォーマンス、SSL、DNS、ビジュアルリグレッション、コンテンツの変更という6つのレイヤーを監視します。

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	1回限りのパフォーマンスチェック（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	1回の呼び出しで最大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	1 つのサイトでウェブサイト、SSL、DNS、速度を確認し、対応が必要な項目を要約します。
investigate_broken_site	DNS、証明書、応答、速度を順に調べて問題のあるレイヤーを特定します。API キーが設定されている場合は、インシデントとアラートも確認します。
pre_launch_checklist	新規ドメインまたは移行したドメイン向けの、合格・警告・不合格のチェックリストです。
triage_open_incidents	未解決のインシデントと未確認のアラートを優先順位付けします（API キーが必要です）。

リソース	内容
visualsentinel://plans	プランの制限、および API キーとアカウント用ツールが含まれるプラン。
visualsentinel://help	アカウントなしでのセットアップ、API キーの追加方法、リンク。
visualsentinel://tools	すべてのツール、API キーが必要かどうか、データを変更するかどうか。

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 の実行時に使うシェルで VS_API_KEY をエクスポートします。

Cursor と Grok Bot

このリポジトリはインストール可能なプラグインでもあります。Cursor Marketplace 用の .cursor-plugin/plugin.json と mcp.json、Grok および Claude Code 用の .claude-plugin/plugin.json と .mcp.json が含まれています（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 を使用します。

設定

環境変数は 2 つあり、特記されている場合を除いて、どちらも任意です。

変数	デフォルト	用途
VS_API_KEY	（なし）	認証が必要な 12 個のツールで必須です（API キーは Business および Agency プランで利用できます）。公開ツールはキーなしで動作します。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 時間のインシデントを表示して、モニター 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 キーなしで使用できますが、その結果は会話ログを読める人なら誰でも確認できます。ほかのシェルコマンドと同様に扱ってください。
• 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 リクエストをパイプで渡すと、登録済みのツールを確認できます。

バージョン管理

セマンティックバージョニングを採用しています。ツール名または必須引数に対する破壊的変更ではメジャーバージョンを上げます。ツールの追加や新しい任意引数の追加では、マイナーバージョンまたはパッチバージョンを上げます。

サーバーが提供するツールは、公開されている Visual Sentinel API 仕様（https://github.com/VisualSentinel/openapi）に準拠しています。上流 API に有用なエンドポイントが追加されると、このリポジトリも通常、次のリリースまでに対応します。

ライセンス

MIT です。詳細は LICENSE を参照してください。

Visual Sentinel API サービス自体には、https://visualsentinel.com/terms が適用されます。