Hanwha Vision Camera MCP Server

MCP server for configuring Hanwha Vision (Wisenet) IP cameras. Connects via SUNAPI and exposes 30+ tools for device info, live snapshots, video profiles, image tuning, overlays, OSD, NTP, network, events, security, and storage management.

Install

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "Hanwha": {
      "command": "npx",
      "args": ["-y", "@hemla/hanwha-mcp@0.3.1"]
    }
  }
}

Restart Claude Desktop after adding.

Usage

Once installed, ask your AI assistant to connect to a camera:

"Connect to my Hanwha camera at 192.168.1.100 with username admin and password mypass"

Then interact naturally:

"Take a snapshot"

"Show me all video profiles"

"Set the title overlay to Building A - Lobby"

"What are the current image settings?"

"Configure NTP to use pool.ntp.org"

"Enable tampering detection with 80% sensitivity"

Tools

Connection

Device & Snapshots

Video Profiles

Image Settings

White Balance & SSDR

Privacy Mask

Overlays & OSD

Date, Time & NTP

Event Detection

Event Rules

Network

Security & Users

Storage & Recording

System

All read-only tools are annotated for automatic approval. Write tools are marked as non-destructive and idempotent. Only reboot_camera, remove_osd, remove_video_profile, and remove_user require confirmation.

Compatibility

Works with Hanwha Vision cameras that expose SUNAPI (/stw-cgi/) endpoints, including Wisenet X, P, Q, A, and L series.

Development

git clone https://github.com/hemla-com/hanwha-mcp.git
cd hanwha-mcp
npm install
npm run dev

# Run tests
npm test

# Run with coverage
npm run test:coverage

License

Copyright (c) 2026 Hemla. Licensed under GPL-3.0.

Derivative works must use the same license and acknowledge Hemla as the original author.