camera-mcp

USB接続の一眼レフ（Canon EOS 6D で開発）を MCP（Model Context Protocol）サーバーとして公開し、 AIアシスタントから自然言語で操作できるようにする試作です。

Wi-Fi API（Canon CCAPI）を持たない世代のカメラでも、Windows用フリーソフト digiCamControl（内部はCanon EDSDK）のCLIをラップすることで 「今夜0時から100秒間隔で、白飛びしないように撮って」が通ります。

これは個人の実験プロジェクトです。 メーカー非公式で、EOS 6D + Windows 環境でしか動作確認していません。

できること（MCPツール9本）

目玉：フィードバック式自動露出（ホーリーグレイル対応）

夜から朝にかけてのタイムラプスは、固定露出だと明け方に必ず白飛びします。 timelapse_start(auto_exposure=True) を指定すると、

撮影 → 届いた画像の平均輝度と白飛び率を測定 → 目標輝度とのズレを 1/3 段刻みで補正 → 次のコマ

というループが回ります（USB接続で撮影画像が即PCに届くことを利用）。

• 明るくする方向：シャッターを長く（上限まで）→ 足りなければISOを上げる

• 暗くする方向：ISOを下げる → その後シャッターを短く

• 1コマあたりの変化量を制限してチラつきを抑制

• 既定はオフ。完全固定露出との比較ができます

実測（8秒/ISO6400 で開始した一晩、203コマ）では、夜明けの平均輝度を最大149.4・白飛び率1.4%に抑えて 約100分で16段ぶん露出を下げ切りました。

Related MCP server: Webcam MCP

必要なもの

• Windows（digiCamControl が Windows 専用のため）

• Python 3.10 以上

• digiCamControl（winget install digiCamControl など）

  • 同梱の ffmpeg.exe を動画生成に使います

• digiCamControl 対応のカメラ（USB接続。開発機は Canon EOS 6D）

• Python パッケージ：fastmcp==3.4.4 / Pillow

インストール

cd C:\path\to\camera-mcp
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

動作確認（カメラ不要のオフラインテスト）:

.\.venv\Scripts\python.exe test_ae.py

実機での通しテスト（実際にシャッターを4回切ります）:

.\.venv\Scripts\python.exe test_e2e.py

MCPサーバーとして登録する

Claude Code の場合:

claude mcp add camera --scope user -- C:\path\to\camera-mcp\.venv\Scripts\python.exe -m camera_mcp

設定ファイルに直接書く場合（claude_desktop_config.json 等）:

{
  "mcpServers": {
    "camera": {
      "command": "C:\\path\\to\\camera-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "camera_mcp"],
      "env": {
        "CAMERA_MCP_DATA_DIR": "D:\\CameraMCP\\sessions"
      }
    }
  }
}

pip install -e . をしていない場合は、スクリプトを直接指すこともできます （args を ["C:\\path\\to\\camera-mcp\\src\\camera_mcp\\server.py"] にする）。

登録後は「1枚撮って」「ISOを800にして」「30秒間隔で撮影開始」といった日本語で呼び出せます。

設定（環境変数）

すべて任意。既定値のままで標準構成なら動きます（src/camera_mcp/config.py）。

保存先はクラウド同期フォルダの外にすること。 一晩で1,000枚・数GBになるため、 OneDrive等の配下に置くと同期が破綻します（digiCamControl の既定保存先は同期フォルダ配下なので要変更）。

撮影前のチェックリスト（実戦で効いたもの）

• 電源：一晩撮るならACアダプター推奨。バッテリー運用ならGPS・Wi-Fi・撮影後の画像表示を「切」に

• オートパワーオフを「切」に

• ホワイトバランスは固定（太陽光など）。オートだとコマごとに色基準が変わり、後処理の色解析が成立しない

• 置きピン：AFで合わせてからレンズをMFへ。autofocus=False で撮影する

• カメラ内蔵時計を合わせる（EXIFの時刻がずれる。本実装の log.jsonl はPC側の時刻を記録している）

• ae_max_shutter は撮影間隔より必ず短く（露光がインターバルを超えるとリズムが崩れる）

• シャッター耐久は有限（EOS 6D は約10万回）。間隔と枚数は意識して設計する

既知の制約

• Windows専用・digiCamControl依存。EOS 6D 以外は未検証

• digiCamControl と EOS Utility は同時にカメラを掴めない（EOS Utility は終了しておく）

• セッションを閉じるとジョブも止まる：撮影ループはMCPサーバープロセス内のスレッドで動くため、 クライアント（Claude Code等）を終了するとサーバーごと落ちます。常駐デーモン化は未対応

• ジョブは同時に1本だけ

• 測光は全画面平均（200pxサムネイル）。中央重点もROI指定も無いので、 構図内の変化（花が開く等）を明るさの変化と誤認することがあります

• 白飛び率は縮小画像で測定しているため、実際よりやや小さく出ます（相対比較用の指標）

• 露出ステップはEVではなくリストのインデックスを数えています。高感度域は刻みが粗いので、 「1コマ最大1段」の意図に対して実際は1段を超えて動くことがあります

• P制御＋デッドバンドのみ（ヒステリシス・積分項なし）。境界付近で明滅（ハンチング）することがあります

• 雲によるチラつきは撮影中には消せません。フィードバックは常に1コマ遅れなので、 外光が100秒単位で激変する状況では原理的に間に合いません。後処理（デフリッカー）で処理してください

• UACダイアログや初回接続の承認など、人間の操作が必要な場面があります

先行事例

自動露出ランピング自体は新しい発想ではありません。Magic Lantern の Auto Exposure Ramping、 qDslrDashboard の Auto Holy Grail が同じ考え方を10年以上前から実装しています。 本プロジェクトの位置づけは、その制御ループをMCPツールとして公開し、自然言語で目標を渡せるようにした インターフェース層にあります。

ライセンス

MIT