NX见证MCP
一个模型上下文协议（MCP）服务器，将Claude代码连接到 NX见证VMS （视频管理系统），使克劳德能够通过自然语言与您的安全摄像头系统进行交互。
它的作用
NX Witness MCP将您的NX Witnest系统作为一组Claude工具公开，允许您：
- 列出并检查摄像头、服务器和存储
- 检索实时流URL和快照
- 浏览和搜索录制的镜头
- 管理布局、视频墙和放映盘
- 控制PTZ摄像机（移动、预设、巡视）
- 管理用户、用户组和权限
- 创建和管理书签、规则和触发器
- 监控系统运行状况、指标和警报
- 管理集成和分析引擎
- 还有更多-完整的NX Witness REST API表面
多系统支持允许您同时连接到多个NX Witness站点。每个工具都需要一个 system 参数--调用 nx_read_list_systems 首先发现可用的系统名称，然后将一个传递给每个后续的工具调用。
______________________________________________________________________
先决条件
- Python 3.9或更高版本
pip- 对NX Witness服务器的网络访问
- Claude Code（命令行界面或桌面应用程序）
______________________________________________________________________
安装
git clone
cd nx-meta-mcp
pip install -r requirements.txt______________________________________________________________________
配置
复制示例配置并填写您的系统凭据：
cp nx_systems.example.json nx_systems.json编辑 nx_systems.json 使用您的NX Witness系统详细信息。支持三种连接模式：
直接（局域网或VPN）
{
"systems": {
"OfficeMain": {
"host": "https://192.168.1.100:7001",
"user": "admin",
"pass": "your_password"
}
}
}vmproxy-Relay（通过NX Cloud中继进行远程访问）
{
"systems": {
"RemoteSite": {
"host": "https://xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.relay.vmsproxy.com",
"user": "admin",
"pass": "your_password"
}
}
}Tailscale（零配置网状VPN）
{
"systems": {
"RemoteSite": {
"host": "https://your-host.tail12345.ts.net:7001",
"user": "admin",
"pass": "your_password"
}
}
}您可以根据需要定义任意多的系统。 nx_systems.json 被排除在版本控制之外——永远不要提交它。
______________________________________________________________________
运行服务器
python server.py服务器通过stdio进行通信，旨在由Claude Code主机进程启动，而不是直接在终端中运行。
______________________________________________________________________
Claude代码集成
将服务器添加到您的Claude Code MCP配置中。在你的 claude_desktop_config.json （或Claude Code安装的等效设置）：
{
"mcpServers": {
"nx-witness": {
"command": "python",
"args": ["/absolute/path/to/nx-meta-mcp/server.py"]
}
}
}或者通过Claude Code CLI：
claude mcp add nx-witness python /absolute/path/to/nx-meta-mcp/server.py添加服务器后重新启动Claude Code。您应该看到Claude中提供的NX Witness工具。
关于命名空间的说明
此服务器将自己注册为 "nx-witness".所有工具都出现在克劳德代码下 mcp__nx-witness__ 前缀（例如。 mcp__nx-witness__nx_read_list_cameras).
一些NX Witness安装还暴露了内置的MCP连接器（有时列为 "NXWitness" 或 "nx-meta" 在Claude Code的连接器设置中）。如果此服务器和内置连接器同时注册，则工具将显示在 两个独立的命名空间 随着 独立权限设置 --这可能会导致混淆使用哪个命名空间，或者为什么启用一个命名空间不会影响另一个命名空间。
建议： 一次只使用一个MCP集成。要获得完整的工具覆盖和多系统支持，请专门使用此服务器，并删除或禁用任何其他NX Witness连接器。
______________________________________________________________________
可用工具
| 类别 | 工具 |
|---|---|
| 系统 | nx_read_list_systems, nx_read_server_info, nx_read_list_servers |
| 相机和设备 | nx_read_list_cameras, nx_read_get_camera, nx_write_create_device, nx_update_replace_device, nx_update_modify_device, nx_delete_device, nx_read_get_device_status, nx_read_get_device_io, nx_update_set_device_io, nx_read_camera_snapshot, nx_read_camera_stream_url |
| 设备搜索 | nx_read_list_device_searches, nx_write_start_device_search, nx_read_get_device_search, nx_delete_stop_device_search, nx_read_get_device_types, nx_read_get_device_diagnosis, nx_read_get_all_devices_diagnosis |
| 录音 | nx_read_get_footage |
| PTZ | nx_read_ptz_get_position, nx_write_ptz_set_position, nx_write_ptz_move, nx_delete_ptz_stop, nx_read_ptz_get_presets, nx_write_ptz_activate_preset |
| 存储 | nx_read_list_storages, nx_read_get_storage_status |
| 用户 | nx_read_list_users |
| 书签 | nx_read_list_bookmarks, nx_read_get_bookmark, nx_write_create_bookmark, nx_update_bookmark, nx_delete_bookmark |
| 活动 | nx_read_get_events, nx_read_get_event_manifest_events, nx_read_get_event_manifest_actions |
| 确认 | nx_read_get_acknowledges, nx_write_acknowledge_event, nx_read_get_acknowledge |
| 触发器 | nx_read_get_triggers, nx_read_get_trigger, nx_write_fire_trigger |
| 规则 | nx_read_get_rules, nx_read_get_rule, nx_write_create_rule, nx_update_replace_rule, nx_update_modify_rule, nx_delete_rule, nx_write_reset_rules |
| 一般事件 | nx_write_create_generic_event |
| 分析和集成 | nx_read_list_analytics_engines, nx_read_list_integrations, nx_read_get_integration, nx_delete_analytics_integration |
| 虚拟上传 | nx_read_virtual_list_uploads, nx_write_virtual_start_upload, nx_read_virtual_get_upload_status, nx_delete_virtual_cancel_upload |
| 日志和审计 | nx_read_get_log_settings, nx_read_get_server_log, nx_read_get_audit_log |
______________________________________________________________________
安全说明
nx_systems.json从git中排除--将凭据排除在版本控制之外- 为了与自签名的NX Witness证书兼容，SSL证书验证当前已禁用
- 使用具有最低特权权限的专用NX Witness用户进行MCP连接
______________________________________________________________________
许可证
麻省理工学院
______________________________________________________________________
更新日志
看 更改日志.md 查看完整版本历史。
v2.0.1（2026年4月1日）
- 固定的
SyntaxError: non-default argument follows default argument关于进口--system: SYS现在是所有18个受影响工具功能中的第一个参数。
v2.0.0（2026-04-01）——重大变革
system现在是必需的 所有工具。呼叫nx_read_list_systems首先获取可用的系统名称，然后将系统名称传递给每个后续的工具调用。这修复了一个可发现性问题，即Claude Desktop默默地省略了可选参数，只查询了默认系统。