Video Still Capture MCP

Video Still Capture MCP

site icon
2025.03.28 6
Python网络摄像头控制图像捕获其它
Video Still Capture MCP 是一个基于 Python 实现的 Model Context Protocol (MCP) 服务器,专门用于通过 OpenCV 访问和控制网络摄像头及视频源。该服务器提供了一系列工具,使语言模型能够捕获图像、调整摄像头设置以及管理视频连接。
View on GitHub

Overview

基本能力

产品定位

Video Still Capture MCP 是一个用于网络摄像头控制和图像捕获的 MCP 服务器,旨在为 AI 助手提供访问和控制摄像头的能力。

核心功能

  • 快速图像捕获:无需管理连接即可从网络摄像头捕获单张图像。
  • 连接管理:打开、管理和关闭摄像头连接。
  • 视频属性:读取和调整摄像头设置,如亮度、对比度和分辨率。
  • 图像处理:基本的图像变换,如水平翻转。

适用场景

  • AI 助手需要访问摄像头进行图像捕获的场景。
  • 需要调整摄像头设置的应用场景。
  • 需要管理多个摄像头连接的应用场景。

工具列表

  1. quick_capture:快速打开摄像头,捕获单帧并关闭。
  2. open_camera:打开与摄像头设备的连接。
  3. capture_frame:从指定的视频源捕获单帧。
  4. get_video_properties:获取视频源的属性。
  5. set_video_property:设置视频源的属性。
  6. close_connection:关闭视频连接并释放资源。
  7. list_active_connections:列出所有活动的视频连接。

常见问题解答

  • 摄像头未找到:确保摄像头已正确连接且未被其他应用程序占用。
  • 权限问题:某些系统需要明确授权才能访问摄像头。
  • OpenCV 安装问题:如果遇到 OpenCV 相关问题,请参考官方安装指南。

使用教程

使用依赖

  • Python 3.10+
  • OpenCV (opencv-python)
  • MCP Python SDK
  • UV (可选)

安装依赖命令:

pip install opencv-python mcp[cli] numpy

安装教程

  1. 克隆仓库:
git clone https://github.com/13rac1/videocapture-mcp.git
cd videocapture-mcp
pip install -e .
  1. 运行 MCP 服务器:
mcp dev videocapture_mcp.py

调试方式

  1. 确保摄像头已连接且未被占用。
  2. 检查权限设置。
  3. 使用 list_active_connections 工具检查活动连接。
  4. 使用 get_video_properties 检查摄像头属性。

许可证

该项目遵循 MIT 开源许可条款。