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/[email protected]"]
    }
  }
}

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

| Tool | Description | Parameters | |---|---|---| | connect_camera | Connect to a camera (required first) | host, username, password, port? (default 80) |

Device & Snapshots

| Tool | Description | Parameters | |---|---|---| | get_device_info | Model, serial, firmware, video profiles | — | | get_snapshot | Live JPEG snapshot (auto-resized) | channel?, profile?, maxWidth? (default 1280) |

Video Profiles

| Tool | Description | Parameters | |---|---|---| | get_video_profiles | List all profiles with encoding, resolution, FPS, bitrate | channel? | | set_video_profile | Update profile encoding, resolution, FPS, bitrate, codec settings | channel?, profile, name?, encodingType?, resolution?, frameRate?, bitrate?, bitrateControlType?, govLength? | | add_video_profile | Add a new video profile | channel?, name, encodingType, resolution, frameRate, bitrate | | remove_video_profile | Remove a video profile | channel?, profile |

Image Settings

| Tool | Description | Parameters | |---|---|---| | get_image_settings | Brightness, sharpness, white balance, exposure, SSDR, flip, IR | channel? | | set_image_settings | Adjust brightness, sharpness, gamma, saturation | channel?, brightness? (0-100), sharpness?, gamma?, saturation? (0-100) | | set_flip | Image flip and rotation | channel?, horizontalFlip?, verticalFlip?, rotate? (Off/90/180/270) | | set_ir_led | IR LED mode | channel?, mode (Auto/Off/On) | | set_focus | Focus mode | channel?, mode (SimpleAutoFocus/ManualFocus) |

White Balance & SSDR

| Tool | Description | Parameters | |---|---|---| | get_white_balance | White balance mode and manual levels | channel? | | set_white_balance | Set mode and optional manual red/blue levels | channel?, mode (ATW/Indoor/Outdoor/Manual), manualRedLevel?, manualBlueLevel? | | get_ssdr | SSDR enable, level, dynamic range | channel? | | set_ssdr | Configure SSDR | channel?, enable?, level?, dynamicRange? (Narrow/Wide) |

Privacy Mask

| Tool | Description | Parameters | |---|---|---| | get_privacy_mask | Privacy mask status and color | channel? | | set_privacy_mask | Enable/disable and set color | channel?, enable?, maskColor? (Gray/White/Black/Red/Blue/Green) |

Overlays & OSD

| Tool | Description | Parameters | |---|---|---| | get_overlay | Title and time overlay settings | channel? | | set_overlay | Configure title text, time format, font | channel?, titleEnable?, title?, titlePositionX?, titlePositionY?, timeEnable?, timeFormat?, weekdayEnable?, fontSize? | | get_osd_list | List multiline OSD entries | channel? | | set_osd | Add/update OSD entry | channel?, index (1-8), enable?, osdType?, text?, positionX?, positionY?, fontSize?, osdColor?, transparency? | | remove_osd | Delete an OSD entry | channel?, index |

Date, Time & NTP

| Tool | Description | Parameters | |---|---|---| | get_datetime | Time, timezone, DST, NTP config | — | | set_ntp | Configure NTP servers | servers (comma-separated) | | set_datetime | Set time manually (disables NTP) | year, month, day, hour, minute, second? |

Event Detection

| Tool | Description | Parameters | |---|---|---| | get_tampering_detection | Tampering detection settings | channel? | | set_tampering_detection | Configure tampering detection | channel?, enable?, sensitivityLevel?, thresholdLevel?, duration?, darknessDetection? | | get_defocus_detection | Defocus detection settings | channel? | | set_defocus_detection | Configure defocus detection | channel?, enable?, sensitivity?, thresholdLevel?, duration? |

Event Rules

| Tool | Description | Parameters | |---|---|---| | get_event_rules | List all event rules | — | | set_event_rule | Enable/disable an event rule | ruleIndex, enable? |

Network

| Tool | Description | Parameters | |---|---|---| | get_network_info | MAC, link status, DNS | — | | get_network_config | Full config: IP, gateway, hostname, ports | — | | set_network_config | Update interface settings | ipv4Type? (DHCP/Static), ipv4Address?, ipv4SubnetMask?, ipv4Gateway?, hostname? |

Security & Users

| Tool | Description | Parameters | |---|---|---| | get_users | List camera users with admin/enabled status | — | | create_user | Create a new user account | username, password, role? (admin/user/viewer, default viewer) | | update_user | Update a user's password or role | username, password?, role? | | remove_user | Remove a user account | username |

Storage & Recording

| Tool | Description | Parameters | |---|---|---| | get_storage_config | Storage enable, overwrite, auto-delete | — | | set_storage_config | Configure storage settings | enable?, overwrite?, autoDeleteEnable?, autoDeleteDays? |

System

| Tool | Description | Parameters | |---|---|---| | get_logs | System, access, or event logs | type (system/access/event) | | reboot_camera | Reboot the camera | — |

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.