Webcam MCP

🚀 Webcam MCP 📸

Webcam MCP 是一個模型上下文協議（MCP）服務器，它能讓大語言模型（LLM）代理直接訪問你的網絡攝像頭。它使自主代理能夠拍攝照片和錄製視頻序列，從而可以在無需人工干預的情況下調試網絡物理系統、監控環境以及與現實世界進行交互。

🚀 快速開始

Webcam MCP 是一個模型上下文協議（MCP）服務器，它能讓大語言模型（LLM）代理直接訪問你的網絡攝像頭。它使自主代理能夠拍攝照片和錄製視頻序列，從而可以在無需人工干預的情況下調試網絡物理系統、監控環境以及與現實世界進行交互。

✨ 主要特性

• 📸 高分辨率照片：拍攝靜態圖像
• 🎥 視頻錄製：在指定時間段內錄製一系列幀
• 🌐 遠程訪問：支持 SSE 傳輸，便於網絡訪問部署
• ⚙️ 可配置：可調整分辨率、攝像頭索引和質量設置
• 🔌 跨平臺：支持 Linux、macOS 和 Windows 系統
• 🚀 易於集成：MCP 客戶端配置簡單

📦 安裝指南

pip install webcam-mcp

啟動 MCP 服務器：

webcam-mcp

默認情況下，服務器將在 http://0.0.0.0:8000/sse 上啟動。

你可以使用任何 MCP 客戶端來測試服務器，例如 MCP Inspector（通過 npx @modelcontextprotocol/inspector 安裝）。

CLI 選項

💻 使用示例

基礎用法

# 在自定義端口啟動
webcam-mcp --port 9000

# 使用不同的攝像頭（例如，外部 USB 網絡攝像頭）
webcam-mcp --camera-index 1

# 自定義照片分辨率
webcam-mcp --photo-width 1280 --photo-height 720

📚 詳細文檔

MCP 客戶端配置

Claude Desktop

將以下內容添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "webcam": {
      "url": "http://localhost:8000/sse"
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

其他 MCP 客戶端

任何支持 SSE 傳輸的 MCP 客戶端都可以連接到：

http://<主機>:<端口>/sse

MCP 工具

take_photo

從網絡攝像頭拍攝一張高分辨率照片。 參數： 無 返回值： JPEG 圖像 在 Claude 中的使用示例：

你能拍張照片並描述你看到的內容嗎？

record_video

在指定時間段內錄製視頻幀。 參數：

• duration_seconds（浮點數，可選）：錄製時長（秒）
  • 最小值：1.0 秒
  • 最大值：60.0 秒
  • 默認值：5.0 秒 返回值： JPEG 幀列表 在 Claude 中的使用示例：

錄製一段 10 秒的視頻，並分析你檢測到的任何運動。

🔧 技術細節

故障排除

攝像頭權限被拒（macOS）

在 macOS 系統上，你需要授予攝像頭權限：

1. 打開 系統設置 → 隱私與安全 → 攝像頭
2. 為 終端（或你的終端應用程序）啟用攝像頭訪問權限
3. 重啟終端並再次嘗試

攝像頭已在使用中

如果你看到 “攝像頭不可用” 錯誤：

1. 關閉其他使用網絡攝像頭的應用程序（如 Zoom、Skype 等）
2. 檢查是否有另一個 webcam-mcp 實例正在運行
3. 嘗試使用不同的攝像頭索引：webcam-mcp --camera-index 1

攝像頭索引錯誤

要查找可用的攝像頭：

import cv2
for i in range(10):
    cap = cv2.VideoCapture(i)
    if cap.isOpened():
        print(f"攝像頭 {i}: 可用")
        cap.release()
    else:
        print(f"攝像頭 {i}: 不可用")

然後使用正確的編號設置 --camera-index。

分辨率不支持

如果你的攝像頭不支持請求的分辨率，服務器將：

• 記錄一條警告信息，顯示實際達到的分辨率
• 繼續使用攝像頭支持的最大分辨率運行 檢查日誌中是否有類似以下的消息：

WARNING: Requested resolution 1920x1080, but camera provided 1280x720

開發

# 以可編輯模式安裝幷包含開發依賴項
pip install -e ".[dev]"

# 運行所有測試
pytest

# 以詳細輸出模式運行
pytest -v

# 運行特定的測試文件
pytest tests/test_camera.py

所有測試都使用模擬的攝像頭硬件，因此測試時無需物理網絡攝像頭。

發佈

要標記併發布新版本，請將包含新 __version__ 字符串的新提交推送到 main 分支。這將觸發一個新的標籤，並將新版本推送到 PyPI。

📄 許可證

本項目採用 MIT 許可證。