MCP Camera Tool
MCP Camera Tool 是一个基于MCP(Model Context Protocol)框架的摄像头工具服务,允许AI助手访问和控制网络摄像头,捕获图像并进行分析处理。
功能特性
- 摄像头连接管理(打开/关闭)
- 图像捕获功能
- 摄像头参数调整(亮度、对比度等)
- 基础图像处理
- 图像内容分析(亮度、颜色分布、边缘检测等)
- MCP协议集成
技术栈
- Python 3.14+
- MCP (Model Context Protocol) v1.23.3
- OpenCV for camera operations
- uv 包管理器
- FastMCP框架
安装步骤
- 克隆项目仓库
- 安装依赖:
uv sync
运行服务
使用uv运行MCP摄像头服务:
uv run mcp-camera
或者直接运行主程序:
uv run python main.py
权限说明
在macOS上,首次运行时可能需要授予终端应用程序摄像头访问权限:
- 打开系统偏好设置
- 进入"安全性与隐私"
- 在"隐私"标签页中选择"相机"
- 勾选您正在使用的终端应用程序
测试摄像头功能
可以运行单独的测试脚本来验证摄像头是否正常工作:
uv run python test_camera.py
与AI系统集成
要将此工具集成到支持MCP的AI系统(如Claude)中,请参考相应系统的文档配置MCP服务。
服务启动时会显示相关信息:
- 使用FastMCP框架实现
- 通过stdio协议通信
- 提供capture_and_analyze_image工具用于捕获并分析摄像头图像
项目结构
mcp_camera/
├── main.py # 程序入口点
├── camera_service.py # 摄像头服务核心实现
├── image_analyzer.py # 图像分析服务
├── test_camera.py # 摄像头测试脚本
├── test_image_analyzer.py # 图像分析器测试脚本
├── pyproject.toml # 项目配置文件
├── uv.lock # 依赖锁定文件
└── README.md # 项目说明文档
