🚀 OpenCV MCP Server

🚀 OpenCV MCP Server

site icon
2025.04.12 3
Python计算机视觉图像处理视频分析内容生成
OpenCV MCP Server 是一个基于 Python 的 MCP(Model Context Protocol)服务,提供强大的 OpenCV 计算机视觉能力。它允许 AI 助手和语言模型访问从基本图像处理到高级对象检测和跟踪的各种计算机视觉工具。
View on GitHub

Overview

基本能力

产品定位

OpenCV MCP Server 是一个提供计算机视觉能力的 MCP 服务,旨在为 AI 系统提供图像和视频处理功能。

核心功能

  • 基本图像处理(读取、保存、转换)
  • 图像增强(调整大小、裁剪、应用滤镜)
  • 边缘检测和轮廓分析
  • 高级计算机视觉能力(特征检测、对象检测)
  • 人脸检测和识别
  • 视频处理和分析(帧提取、运动检测)
  • 视频中的对象跟踪
  • 实时对象检测的摄像头集成

适用场景

  • 自主系统:视觉导航和障碍物检测
  • 交通分析:车辆计数、速度估计和车牌识别
  • 安全系统:运动检测和人脸识别
  • 增强现实:特征跟踪和姿态估计
  • 医疗影像:组织分割和异常检测
  • 工业检测:缺陷检测和质量控制
  • 数字艺术:图像过滤和转换
  • 游戏:手势识别和玩家跟踪

工具列表

OpenCV MCP Server 提供四类工具: 1. 图像基础:基本图像操作工具 2. 图像处理:高级图像处理工具 3. 计算机视觉:高级视觉能力工具 4. 视频处理:视频分析和处理工具

常见问题解答

  • 模型文件需要放置在 OPENCV_DNN_MODELS_DIR 环境变量指定的目录中
  • 默认使用 stdio 传输方法
  • 需要预训练模型才能使用对象检测功能

使用教程

使用依赖

需要安装 Python 和 OpenCV 相关依赖。

安装教程

pip install opencv-mcp-server

对于开发环境:

git clone https://github.com/yourusername/opencv-mcp-server.git
cd opencv-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

调试方式

配置环境变量:

export MCP_TRANSPORT="stdio"
export OPENCV_DNN_MODELS_DIR="models"

基本 Python 使用示例:

from opencv_mcp_server import opencv_client
client = opencv_client.OpenCVClient()
result = client.resize_image(image_path="input.jpg", width=800, height=600)

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。