camera-mcp

通过 ffmpeg / DirectShow，把本机摄像头能力暴露给 Claude 的 MCP server。

让 Claude 可以直接：列出摄像头 → 拍照 → 录像 → 停止录像，全程本地处理，文件落到磁盘。

功能

Related MCP server: Webcam MCP

环境要求

• Windows（用了 DirectShow，Linux/macOS 需要换 avfoundation / v4l2）

• Node.js ≥ 18

• ffmpeg（在 PATH 里，或自行改成绝对路径）

# Windows 用 winget 装 ffmpeg
winget install ffmpeg

安装 & 构建

cd camera
npm install
npm run build

构建产物在 dist/index.js，可执行项 camera-mcp。

配置到 Claude Code

在 ~/.claude/mcp.json（或项目级 .mcp.json）里加：

{
  "mcpServers": {
    "camera": {
      "command": "node",
      "args": ["C:/Users/hj158/mcp-servers/camera/dist/index.js"]
    }
  }
}

启动后用 claude mcp list 应该能看到 camera: ... √ Connected。

使用示例

帮我拍一张照片

Claude 会调：

take_photo(device="HD Webcam", path="./photos/test.jpg", quality=2)

用 ToDesk Camera 录一段 30 秒视频

start_recording(device="ToDesk Camera", path="./videos/demo.mp4")
# → recording_id: rec_xxxxxxxx_1
# ... 30 秒后 ...
stop_recording(recording_id="rec_xxxxxxxx_1")

工具参数

take_photo

start_recording

stop_recording

工作原理

• 设备枚举：调 ffmpeg -list_devices true -f dshow -i dummy，正则匹配 "..." (video) 行

• 拍照：spawn ffmpeg，-frames:v 1 -q:v <quality> 截单帧

• 录像：spawn ffmpeg 保持长连接，用 Map<recording_id, ChildProcess> 跟踪；停止时往 stdin 写 q，让 ffmpeg 走正常退出流程（否则 mp4 moov 索引缺失，很多播放器打不开）

已知限制

• Windows-only（DirectShow）；跨平台需要按平台分支选择 input format

• 多进程隔离：每次拍照/录像都新 spawn 一个 ffmpeg，启动开销约 300-500ms

• 录像启动 500ms 后才检查 exit code，极端情况下启动失败可能要等一下才能发现

License

MIT