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를 통신합니다.

구성

두 가지 환경 변수가 있으며, 명시된 경우를 제외하고는 모두 선택 사항입니다:

인증이 필요한 도구를 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 의 적용을 받습니다.