MCP Web Cam

MCP网络摄像头服务器

一种用于控制网络摄像头的模型上下文协议（MCP）服务器。此服务器使LLM能够通过MCP协议捕获照片、录制视频和管理相机设置。

安装为MCP服务器

适用于Claude桌面应用程序

选项1：使用npx（推荐）

添加到您的Claude Desktop配置中：

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "webcam": {
      "command": "npx",
      "args": [
        "-y",
        "@kmizu/mcp-web-cam"
      ]
    }
  }
}

然后重新启动Claude Desktop。

选项2：手动安装

1. 安装依赖项并构建：

git clone https://github.com/mizushima/mcp-web-cam.git
cd mcp-web-cam
npm install
npm run build

1. 添加到您的Claude Desktop配置中：

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "webcam": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-web-cam/dist/index.js"]
    }
  }
}

1. 重新启动克劳德桌面

对于其他MCP客户端

服务器通过stdio进行通信，因此您可以运行：

node /path/to/mcp-web-cam/dist/index.js

特性

• 照片拍摄：使用可自定义设置拍摄高质量照片
• 视频录制：使用各种格式和编解码器录制视频
• 摄像头管理：列出可用摄像头并调整设置
• 图像处理：基本图像处理功能
• 跨平台：支持Linux、Windows和macOS

安装

全局安装（用于MCP外部）

npm install -g @kmizu/mcp-web-cam

地方发展

npm install
npm run build

用法

作为MCP服务器

服务器可以与任何兼容MCP的客户端一起使用：

npm start

发展

npm run dev    # Watch mode for development
npm run build  # Build TypeScript
npm run typecheck  # Type checking only

可用工具

select_camera

打开一个现代的web UI，从具有实时预览的可用相机中进行选择。

特征：

• 所有连接摄像头的实时预览
• 可用时基于WebRTC的预览
• 回退到快照模式以实现兼容性
• 持续选择摄像头

get_current_camera

获取当前选定的相机设备。

capture_photo

使用网络摄像头拍照。

参数：

• width （可选）：图像宽度（像素）（320-3840）
• height （可选）：图像高度（像素）（240-2160）
• quality （可选）：图像质量（1-100）
• format （可选）：图像格式（“jpeg”、“png”、“bmp”）
• return_type （可选）：如何返回数据（“位置”、“缓冲区”、“base64”）
• device （可选）：相机设备ID

start_recording

开始从网络摄像头录制视频。

参数：

• duration （可选）：录制持续时间（秒）（1-3600）
• fps （可选）：每秒帧数（1-60）
• format （可选）：视频格式（“mp4”、“avi”、“mkv”）
• codec （可选）：视频编解码器（例如，“libx264”、“libx265”）

stop_recording

停止当前视频录制。

list_cameras

列出所有可用的相机设备。

get_camera_settings

获取当前相机设置。

参数：

• device （可选）：相机设备ID

set_camera_settings

调整相机设置，如亮度、对比度等。

参数：

• device （可选）：相机设备ID
• brightness （可选）：亮度级别（0-100）
• contrast （可选）：对比度级别（0-100）
• saturation （可选）：饱和度（0-100）
• hue （可选）：色调调整（-180至180）
• gamma （可选）：伽马校正（1-500）
• sharpness （可选）：锐度级别（0-100）
• whiteBalance （可选）：白平衡，单位为开尔文（2000-10000）
• exposure （可选）：曝光补偿（-10到10）
• gain （可选）：增益级别（0-100）
• focus （可选）：聚焦级别（0-100，0=自动）

资源

服务器提供以下资源：

• webcam://cameras：可用相机设备列表
• webcam://captures：拍摄照片列表
• webcam://recordings：录像列表

依赖项

所需的系统依赖关系

Linux

# Ubuntu/Debian
sudo apt-get install v4l-utils ffmpeg

# CentOS/RHEL
sudo yum install v4l-utils ffmpeg

视窗

• FFmpeg（从下载https://ffmpeg.org/)
• Windows媒体基础

macOS

brew install ffmpeg

文件结构

mcp-web-cam/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── webcam/
│   │   ├── controller.ts     # Camera control logic
│   │   └── types.ts          # TypeScript type definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── capture.ts        # Photo capture tool
│   │   ├── recording.ts      # Video recording tools
│   │   └── camera.ts         # Camera management tools
│   └── types/
│       └── node-webcam.d.ts  # Type declarations
├── captures/                 # Captured photos (auto-created)
├── recordings/               # Video recordings (auto-created)
└── dist/                     # Compiled JavaScript

许可证

麻省理工学院