MCP CamStream Analyzer

by l1b0k

302 downloads
Not rated
GitHub

About

MCP CamStream Analyzer is a tool for collecting and analyzing content from cameras and RTSP video streams. It integrates with any OpenAI-compatible API to generate descriptions and analyses of images and video frames.

Details

Author
l1b0k
Downloads
302
Categories
Other

- Image analysis using customizable description templates
- Video analysis with frame-by-frame or full-video mode
- Support for default, USB, and RTSP camera streams
- Integration with any OpenAI-compatible API
- Configurable frame interval and output directory
- Built-in prompt templates (default, detailed, security)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP CamStream Analyzer
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with pip install -r requirements.txt, edit the auto-generated config.yaml (especially the api_key field), and run python main.py. The service then processes camera feeds according to the configured templates and video analysis settings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp camstream analyzer": {
            "mcp_camstream_analizer": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp_camstream_analizer": {
        "command": "python",
        "args": [
            "main.py"
        ]
    }
}

MCP CamStream Analyzer

MCP CamStream Analyzer is a tool for collecting and analyzing content from cameras and RTSP video streams. It supports integration with any OpenAI-compatible API for detailed content analysis.

Features

- Image Analysis: Generate descriptions based on templates by providing image files.
- Video Analysis: Supports frame-by-frame analysis or entire video analysis.
- Multi-Camera Support: Supports system default cameras, external USB cameras, and RTSP stream cameras.

Quick Start

1. Clone the project:

   git clone <repository-url>
cd mcp_camstream_analizer

2. Install dependencies:

   pip install -r requirements.txt

3. Configuration:
The default configuration file is config.yaml, which will be automatically generated on the first run. Modify the configuration as needed, especially the api_key.

4. Run the service:

   python main.py

Configuration

Example configuration file:

model: gpt-4-vision-preview
base_url: null
cameras:
default: 0
webcam1: 1
ip_camera1:
rtsp_url: rtsp://admin:password@192.168.1.100:554/stream1
buffer_size: 5
output_dir: output
prompt_templates:
default: Describe what you see in this image.
detailed: Provide a detailed analysis of the scene, people, and events happening in this image.
security: This is a security monitoring image. Are there any abnormalities or situations that need attention? Describe in detail what you see.
video_analysis:
mode: frames
frame_interval: 30
api_key: ""

Contribution

Feel free to submit issues and contribute code!

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.