YOLO MCP Service

YOLO MCP Service

site icon
2025.03.11 7
Python计算机视觉图像处理AI集成内容生成
YOLO MCP Service 是一个强大的计算机视觉服务,集成了 YOLO(You Only Look Once)模型,并通过 Model Context Protocol (MCP) 与 Claude AI 无缝集成。该服务能够执行对象检测、分割、分类和实时摄像头分析,支持模型训练、验证和导出,适用于多种图像分析场景。
View on GitHub

Overview

基本能力

产品定位

YOLO MCP Service 是一个基于 YOLO 模型的计算机视觉服务,旨在通过 MCP 协议与 Claude AI 集成,提供高效的图像分析和处理能力。

核心功能

  • 对象检测:识别图像中的对象及其位置。
  • 图像分割:识别对象边界并生成分割掩码。
  • 图像分类:对图像内容进行分类。
  • 实时摄像头分析:通过摄像头进行实时对象检测。
  • 模型训练与验证:支持自定义模型的训练和验证。
  • 模型导出:将模型导出为不同格式(如 ONNX)。
  • 多模型支持:支持多种 YOLO 模型(如 yolov8n.pt、yolov8n-seg.pt 等)。

适用场景

  • 实时监控:通过摄像头进行实时对象检测。
  • 图像分析:对静态图像进行对象检测、分类和分割。
  • 模型开发:训练和验证自定义对象检测模型。
  • 集成应用:与 Claude AI 集成,扩展其图像处理能力。

工具列表

  • list_available_models:列出系统中可用的模型。
  • analyze_image_from_path:从文件路径分析图像中的对象。
  • comprehensive_image_analysis:执行综合图像分析(检测、分类等)。
  • segment_objects:执行图像分割。
  • classify_image:对图像进行分类。
  • start_camera_detection:启动实时摄像头检测。
  • get_camera_detections:获取摄像头检测结果。
  • stop_camera_detection:停止摄像头检测。
  • train_model:训练自定义模型。
  • validate_model:验证模型性能。
  • export_model:导出模型为其他格式。
  • test_connection:测试服务连接状态。

常见问题解答

  • 摄像头问题:尝试不同的摄像头 ID(0、1、2)。
  • 模型未找到:确保模型已下载到配置的目录中。
  • 性能问题:使用较小的模型(如 yolov8n.pt)以提高性能。

使用教程

使用依赖

  • Python 3.10 或更高版本
  • Git(可选,用于克隆仓库)

安装教程

  1. 创建项目目录并进入: bash mkdir yolo-mcp-service cd yolo-mcp-service
  2. 克隆仓库或复制文件: bash git clone https://github.com/GongRzhe/YOLO-MCP-Server.git .
  3. 创建虚拟环境: bash python -m venv .venv # Windows python3 -m venv .venv # macOS/Linux
  4. 激活虚拟环境: bash .venv\Scripts\activate # Windows source .venv/bin/activate # macOS/Linux
  5. 运行安装脚本: bash python setup.py
  6. 下载 YOLO 模型: bash mkdir models curl -L https://github.com/ultralytics/assets/releases/download/v0.0.0/yolov8n.pt -o models/yolov8n.pt curl -L https://github.com/ultralytics/assets/releases/download/v0.0.0/yolov8n-seg.pt -o models/yolov8n-seg.pt curl -L https://github.com/ultralytics/assets/releases/download/v0.0.0/yolov8n-cls.pt -o models/yolov8n-cls.pt curl -L https://github.com/ultralytics/assets/releases/download/v0.0.0/yolov8n-pose.pt -o models/yolov8n-pose.pt

调试方式

  1. 测试服务连接: ``` Is the YOLO service running correctly?

2. 列出可用模型: I'd like to use the YOLO tools. Can you first check which models are available on my system?

3. 分析图像: Can you analyze this image file for objects?

/path/to/your/image.jpg 0.3 ```

许可证

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