# camera-mcp

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

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

---

## 功能

| 工具 | 说明 |
|------|------|
| `list_cameras` | 列出本机所有 DirectShow 视频设备 |
| `take_photo` | 用指定摄像头拍一张 JPEG |
| `start_recording` | 后台开始录像（libx264 / mp4），返回 `recording_id` |
| `stop_recording` | 优雅停止录像（写 q → ffmpeg 自动收尾，写入 moov 索引） |
| `list_recordings` | 列出当前所有进行中的录像 |

---

## 环境要求

- **Windows**（用了 DirectShow，Linux/macOS 需要换 `avfoundation` / `v4l2`）
- **Node.js ≥ 18**
- **ffmpeg**（在 PATH 里，或自行改成绝对路径）

```bash
# Windows 用 winget 装 ffmpeg
winget install ffmpeg
```

---

## 安装 & 构建

```bash
cd camera
npm install
npm run build
```

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

---

## 配置到 Claude Code

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

```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`

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `device` | string | ✅ | 设备名（必须来自 `list_cameras`） |
| `path` | string |   | 保存路径，默认 `./photos/photo-{timestamp}.jpg` |
| `quality` | number |   | JPEG 质量 1-31，**数字越小质量越高**，默认 2 |

### `start_recording`

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `device` | string | ✅ | 设备名 |
| `path` | string |   | 默认 `./videos/video-{timestamp}.mp4` |
| `resolution` | string |   | 默认 `1280x720` |
| `fps` | number |   | 1-60，默认 30 |

### `stop_recording`

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `recording_id` | string | ✅ | `start_recording` 返回的 ID |

---

## 工作原理

- **设备枚举**：调 `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