AI 어시스턴트가 웹사이트 상태를 모니터링하고, DNS 및 SSL 체크를 수행하며, 시각적 회귀 및 업타임 모니터를 관리할 수 있도록 지원합니다.
다른 이름 VisualSentinel/mcp-server, mcp-server, @visualsentinel/mcp-server
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.2.3
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
Visual Sentinel MCP란?
AI 어시스턴트가 웹사이트 상태를 모니터링하고, DNS 및 SSL 체크를 수행하며, 시각적 회귀 및 업타임 모니터를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Visual Sentinel MCP server 정보
Visual Sentinel은 AI 어시스턴트가 업타임, 성능, SSL, DNS, 시각적 회귀 및 콘텐츠 변경을 포함한 6가지 계층에서 웹사이트 상태를 모니터링할 수 있도록 하는 MCP server를 제공합니다. Claude Desktop, Cursor, Cline, Continue와 같은 MCP 호환 클라이언트를 사용하는 개발자가 사이트 신뢰성 작업을 자동화할 수 있도록 설계되었습니다. 이 서버는 stdio를 통해 로컬에서 작동하며 npx 또는 Docker를 사용하여 배포할 수 있습니다.
사용자는 계정 없이도 5가지 공개 도구에 접근하여 DNS, SSL 및 속도 체크를 수행할 수 있습니다. 더 심도 있는 관리를 위해서는 Visual Sentinel 계정과 API key가 필요합니다. 인증을 통해 AI 어시스턴트는 모니터를 관리하고, 인시던트 이력을 가져오며, 알림을 확인하는 작업을 수행할 수 있습니다. 서버에는 17개의 도구와 함께, 서버가 기술적으로 온라인 상태임에도 페이지가 깨져 보이는 원인을 진단하는 데 도움을 주는 investigate_broken_site와 같은 특화된 프롬프트가 포함되어 있습니다.
활용 사례
- 1웹사이트 연결 문제 진단특정 도메인에 대한 DNS 레코드나 SSL 인증서 유효성을 조사하도록 어시스턴트에게 요청합니다.
- 2활성 사이트 모니터 관리AI에게 새로운 HTTPS 모니터를 생성하거나 현재 오프라인 상태인 기존 모니터 목록을 요청합니다.
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
서버를 사용하려면 계정이 필요한가요?
아니요, 공개 도구를 사용하면 계정 없이도 모든 사이트에 대해 DNS, SSL 및 속도 체크를 실행할 수 있습니다.
어떤 도구에 API key가 필요한가요?
모니터 생성, 인시던트 목록 조회, 알림 확인과 같은 인증 기반 도구는 VS_API_KEY가 필요합니다. 이 키는 모든 유료 플랜과 10일 무료 체험에서 제공됩니다.
API key는 안전한가요?
네, API key는 MCP server가 실행 중인 머신을 절대 벗어나지 않으며, 모든 요청은 HTTPS를 통해 서비스로 직접 전송됩니다.