비디오 스틸 캡처 MCP

OpenCV를 통해 웹캠에 액세스하고 제어하기 위한 모델 컨텍스트 프로토콜 서버

개요

비디오 스틸 캡처 MCP는 모델 컨텍스트 프로토콜(MCP)의 파이썬 구현으로, AI 어시스턴트가 OpenCV를 통해 웹캠과 비디오 소스에 접근하고 제어할 수 있도록 합니다. 이 서버는 언어 모델이 이미지를 캡처하고, 카메라 설정을 조작하고, 비디오 연결을 관리할 수 있도록 하는 도구 세트를 제공합니다. 비디오 캡처 기능은 없습니다.

예시

다음은 비디오 스틸 캡처 MCP 서버가 실제로 작동하는 몇 가지 예입니다.

오렌지 예시

왼쪽: 클로드가 이미지를 보는 관점	오른쪽: 실제 웹캠 캡처

자석 예

왼쪽: 클로드가 이미지를 보는 관점	오른쪽: 실제 웹캠 캡처

설치

필수 조건

파이썬 3.10+
OpenCV ( opencv-python )
MCP 파이썬 SDK
UV (선택 사항)

소스에서 설치

지엑스피1

MCP 서버를 실행합니다.

mcp dev videocapture_mcp.py

데스크톱용 Claude와 통합

맥OS/리눅스

Claude Desktop 구성을 편집하세요.

# Mac
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Linux
nano ~/.config/Claude/claude_desktop_config.json 

다음 MCP 서버 구성을 추가합니다.

{
  "mcpServers": {
    "VideoCapture ": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "numpy",
        "--with",
        "opencv-python",
        "mcp",
        "run",
        "/ABSOLUTE_PATH/videocapture_mcp.py"
      ]
    }
  }
}

/ABSOLUTE_PATH/videocapture-mcp 프로젝트의 절대 경로로 바꿔야 합니다.

윈도우

Claude Desktop 구성을 편집하세요.

nano $env:AppData\Claude\claude_desktop_config.json

다음 MCP 서버 구성을 추가합니다.

{
  "mcpServers": {
    "VideoCapture": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "numpy",
        "--with",
        "opencv-python",
        "mcp",
        "run",
        "C:\ABSOLUTE_PATH\videocapture-mcp\videocapture_mcp.py"
      ]
    }
  }
}

C:\ABSOLUTE_PATH\videocapture-mcp 프로젝트의 절대 경로로 바꿔야 합니다.

설치 명령 사용

또는 mcp CLI를 사용하여 서버를 설치할 수 있습니다.

mcp install videocapture_mcp.py

이렇게 하면 Claude Desktop이 자동으로 비디오 캡처 MCP 서버를 사용하도록 구성됩니다.

통합이 완료되면 Claude가 요청 시 웹캠이나 비디오 소스에 접근할 수 있습니다. Claude에게 사진 촬영이나 웹캠 관련 작업을 요청하기만 하면 됩니다.

특징

빠른 이미지 캡처 : 연결을 관리하지 않고 웹캠에서 단일 이미지 캡처
연결 관리 : 카메라 연결 열기, 관리 및 닫기
비디오 속성 : 밝기, 대비, 해상도와 같은 카메라 설정을 읽고 조정합니다.
이미지 처리 : 수평 뒤집기와 같은 기본 이미지 변환

도구 참조

`quick_capture`

카메라를 빠르게 열고 한 프레임을 찍은 다음 닫습니다.

quick_capture(device_index: int = 0, flip: bool = False) -> Image

device_index : 카메라 인덱스(일반적으로 0이 기본 웹캠)
flip : 이미지를 수평으로 뒤집을지 여부
반환 : 캡처된 프레임을 Image 객체로 반환합니다.

`open_camera`

카메라 장치에 대한 연결을 엽니다.

open_camera(device_index: int = 0, name: Optional[str] = None) -> str

device_index : 카메라 인덱스(일반적으로 0이 기본 웹캠)
이름 : 이 카메라 연결을 식별하는 선택적 이름
반환 : 열린 카메라의 연결 ID

`capture_frame`

지정된 비디오 소스에서 단일 프레임을 캡처합니다.

capture_frame(connection_id: str, flip: bool = False) -> Image

connection_id : 이전에 열린 비디오 연결의 ID
flip : 이미지를 수평으로 뒤집을지 여부
반환 : 캡처된 프레임을 Image 객체로 반환합니다.

`get_video_properties`

비디오 소스의 속성을 가져옵니다.

get_video_properties(connection_id: str) -> dict

connection_id : 이전에 열린 비디오 연결의 ID
반환 : 비디오 속성 사전(너비, 높이, fps 등)

`set_video_property`

비디오 소스의 속성을 설정합니다.

set_video_property(connection_id: str, property_name: str, value: float) -> bool

connection_id : 이전에 열린 비디오 연결의 ID
property_name : 설정할 속성의 이름(너비, 높이, 밝기 등)
value : 설정할 값
반환 : 성공하면 True, 그렇지 않으면 False

`close_connection`

비디오 연결을 닫고 리소스를 해제합니다.

close_connection(connection_id: str) -> bool

connection_id : 닫을 연결의 ID
반환 : 성공하면 True

`list_active_connections`

모든 활성 비디오 연결을 나열합니다.

list_active_connections() -> list

반환 : 활성 연결 ID 목록

사용 예

AI 비서가 웹캠 MCP 서버를 사용하는 방법은 다음과 같습니다.

잠깐 사진을 찍어보세요 :
I'll take a photo using your webcam.
(AI는 백그라운드에서 quick_capture() 호출합니다)
지속적인 연결을 엽니다 .
I'll open a connection to your webcam so we can take multiple photos.
(AI는 open_camera() 호출하고 연결 ID를 저장합니다)
카메라 설정 조정 :
Let me increase the brightness of the webcam feed.
(AI는 적절한 매개변수로 set_video_property() 호출합니다)

고급 사용법

자원 관리

서버는 카메라 리소스를 자동으로 관리하여 서버 종료 시 모든 연결이 정상적으로 해제되도록 합니다. 장기 실행 애플리케이션의 경우, 더 이상 필요하지 않은 연결을 명시적으로 종료하는 것이 좋습니다.

여러 대의 카메라

시스템에 여러 대의 카메라가 있는 경우 연결을 열 때 장치 인덱스를 지정할 수 있습니다.

# Open the second webcam (index 1)
connection_id = open_camera(device_index=1)

문제 해결

카메라를 찾을 수 없습니다 . 웹캠이 제대로 연결되어 있고 다른 애플리케이션에서 사용되고 있지 않은지 확인하세요.
권한 문제 : 일부 시스템에서는 카메라에 액세스하기 위해 명시적인 권한이 필요합니다.
OpenCV 설치 : OpenCV에 문제가 발생하면 공식 설치 가이드를 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

Video Still Capture MCP

Integrations