Webcam MCP

🚀 Webcam MCP 📸

Webcamアクセス用のMCPサーバー - LLMエージェント向けの写真撮影と動画録画を可能にします

Webcam MCPは、Model Context Protocol (MCP) サーバーで、LLMエージェントが直接ウェブカメラにアクセスできるようにします。自律エージェントが写真を撮影し、動画シーケンスを録画できるようになり、サイバー物理システムのデバッグ、環境の監視、人間の介入なしでの物理世界とのやり取りが可能になります。

✨ 主な機能

• 📸 高解像度の写真: 静止画像を撮影します。
• 🎥 動画録画: 指定された期間にわたってフレームのシーケンスを録画します。
• 🌐 リモートアクセス: ネットワークアクセス可能な展開のためのSSEトランスポート。
• ⚙️ 設定可能: 解像度、カメラインデックス、品質設定を調整できます。
• 🔌 クロスプラットフォーム: Linux、macOS、Windowsで動作します。
• 🚀 簡単な統合: シンプルなMCPクライアント構成。

🚀 クイックスタート

📦 インストール

pip install webcam-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://<host>:<port>/sse

MCPツール

take_photo

ウェブカメラから1枚の高解像度の写真を撮影します。

• パラメータ: なし
• 返り値: 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"Camera {i}: Available")
        cap.release()
    else:
        print(f"Camera {i}: Not available")

その後、正しい番号で --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ライセンスの下で公開されています。詳細については、こちら を参照してください。