Dahua MCP

大华MCP服务器

MCP服务器，用于通过其CGI HTTP API管理大华/Amcrest IP摄像机。支持单个实例中的多个摄像头，同时支持stdio和HTTP传输。

快速开始

1.创建摄像头配置文件

创建 ~/.config/dahua-mcp/cameras.yaml （或 cameras.json)使用您的相机凭据。这是默认的配置位置——不需要env-var。

对象符号 (cameras.json):

{
  "cameras": [
    {
      "name": "front-door",
      "host": "192.168.1.108",
      "port": 80,
      "username": "admin",
      "password": "secret"
    },
    {
      "name": "backyard",
      "host": "192.168.1.109",
      "port": 80,
      "username": "admin",
      "password": "secret"
    }
  ]
}

YAML (cameras.yaml):

cameras:
  - name: front-door
    host: 192.168.1.108
    port: 80
    username: admin
    password: secret
  - name: backyard
    host: 192.168.1.109
    port: 80
    username: admin
    password: secret

每个摄像头条目支持：

2.添加MCP服务器

选项A：stdio（克劳德代码/克劳德桌面）

使用Claude Code CLI（摄像头配置自动发现） ~/.config/dahua-mcp/):

# From PyPI
claude mcp add dahua-mcp -- uvx dahua-mcp

# From a local clone
claude mcp add dahua-mcp -- uv run --directory /path/to/dahua-mcp dahua-mcp

# With a custom config path
claude mcp add dahua-mcp -e DAHUA_CAMERAS_CONFIG=/path/to/cameras.json -- uvx dahua-mcp

或者手动添加到您的克劳德代码设置中(~/.claude.json)或Claude桌面配置：

{
  "mcpServers": {
    "dahua-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["dahua-mcp"]
    }
  }
}

或者从本地克隆运行：

{
  "mcpServers": {
    "dahua-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/dahua-mcp", "dahua-mcp"]
    }
  }
}

要覆盖配置位置，请添加 env 块：

{
  "env": {
    "DAHUA_CAMERAS_CONFIG": "/custom/path/cameras.yaml"
  }
}

选项B：Docker容器（HTTP传输）

运行装载了配置文件卷的容器：

docker run -d \
  -v /path/to/cameras.json:/config/cameras.json:ro \
  -p 8000:8000 \
  ghcr.io/brianegge/dahua-mcp:latest

然后将HTTP服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "dahua-mcp": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

要在Docker中使用YAML配置：

docker run -d \
  -v /path/to/cameras.yaml:/config/cameras.yaml:ro \
  -e DAHUA_CAMERAS_CONFIG=/config/cameras.yaml \
  -p 8000:8000 \
  ghcr.io/brianegge/dahua-mcp:latest

要添加承载令牌身份验证，请执行以下操作：

docker run -d \
  -v /path/to/cameras.json:/config/cameras.json:ro \
  -e MCP_HTTP_BEARER_TOKEN=your-secret-token \
  -p 8000:8000 \
  ghcr.io/brianegge/dahua-mcp:latest

{
  "mcpServers": {
    "dahua-mcp": {
      "type": "http",
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    }
  }
}

环境变量

除了相机凭据之外的所有设置都是通过环境变量配置的：

可用工具

发现

系统信息

配置读取

配置写入

系统控制

日志

发展

git clone https://github.com/brianegge/dahua-mcp.git
cd dahua-mcp
uv sync
uv run pre-commit install  # Install ruff format/lint hook
uv run pytest              # Run tests
uv run ruff check .        # Lint

许可证

MIT许可证-有关详细信息，请参阅许可证文件。