Visual Sentinel MCP サーバー

Visual Sentinel 用の Model Context Protocol サーバーです。稼働時間、パフォーマンス、SSL、DNS、視覚的リグレッション、コンテンツ変更検知という6層のウェブサイト監視プラットフォームを提供します。

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 を実行するシェルで 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 を使用します。

設定

2つの環境変数があります（注記がある場合を除き、いずれもオプションです）：

認証が必要なツールが VS_API_KEY なしで呼び出された場合、サーバーは黙って失敗するのではなく、明確なエラーを返します。

VISUALSENTINEL_API_KEY は、より長い名前を好むクライアントのために VS_API_KEY のエイリアスとして受け入れられます。

使用例

インストール後、AI アシスタントに以下のように尋ねることができます：

• 「visualsentinel.com の SSL 証明書の状況はどうですか？いつ期限切れになりますか？」

• 「現在ダウンしている Visual Sentinel モニターを一覧表示して。」

• 「https://shop.example.com を1分ごとにチェックする新しい 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 リクエストをパイプで渡すと、登録されているツールを確認できます。

バージョニング

セマンティックバージョニングを採用しています。ツール名や必須引数の破壊的変更はメジャーバージョンアップとなります。新しいツールの追加や新しいオプション引数の追加はマイナーまたはパッチバージョンアップとなります。

サーバーのツールインターフェースは、https://github.com/VisualSentinel/openapi にある公開 Visual Sentinel API 仕様に追従しています。アップストリームの API に有用なエンドポイントが追加された場合、通常はこのリポジトリもリリース内で対応します。

ライセンス

MIT。LICENSE を参照してください。

Visual Sentinel API サービス自体は https://visualsentinel.com/terms に準拠します。