プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

UVC PTZ Camera

作者:AbhijatSaxenaバージョン 0.2.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.AbhijatSaxena/uvc-ptz-camera-mcp

インストール方法

What it does

Control a USB (UVC) pan/tilt/zoom camera, with every move confirmed from the picture.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ7/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア7/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

UVC PTZ Camera をインストールして。https://mcp.popnx.com/i/abhijatsaxena-uvc-ptz-camera-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server UVC PTZ Camera を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "uvc-ptz-camera": { "command": "uvx", "args": [ "uvc-ptz-camera-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、UVC PTZ Camera のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "uvc-ptz-camera": {
          "command": "uvx",
          "args": [
            "uvc-ptz-camera-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    UVC PTZ Camera を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が UVC PTZ Camera を使っていると言うか、回答に UVC PTZ Camera のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UVC_PTZ_STATE_DIR 各カメラについて学習した情報を保存する場所です。既定値は /.uvc-ptz-camera-mcp です。角度のみを保持し、認証情報は保持しません。
    英語の原文を見るWhere to store what has been learned about each camera. Defaults to ~/.uvc-ptz-camera-mcp. Holds angles, never credentials.
  • UVC_PTZ_SIM_SOURCE 合成されたパノラマの代わりにシミュレーターのパノラマとして使用する画像へのパス。
    英語の原文を見るPath to an image to use as the simulator's panorama instead of the synthesised one.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ UVC PTZ Camera につなげません

UVC PTZ Camera はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · UVC PTZ Camera につなげるアプリを使う

  • 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server UVC PTZ Camera を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user uvc-ptz-camera -- uvx uvc-ptz-camera-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、UVC PTZ Camera のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user uvc-ptz-camera -- uvx uvc-ptz-camera-mcp
  4. Claude Code で /mcp と入力

    UVC PTZ Camera が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    UVC PTZ Camera を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が UVC PTZ Camera を使っていると言うか、回答に UVC PTZ Camera のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UVC_PTZ_STATE_DIR 各カメラについて学習した情報を保存する場所です。既定値は /.uvc-ptz-camera-mcp です。角度のみを保持し、認証情報は保持しません。
    英語の原文を見るWhere to store what has been learned about each camera. Defaults to ~/.uvc-ptz-camera-mcp. Holds angles, never credentials.
  • UVC_PTZ_SIM_SOURCE 合成されたパノラマの代わりにシミュレーターのパノラマとして使用する画像へのパス。
    英語の原文を見るPath to an image to use as the simulator's panorama instead of the synthesised one.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server UVC PTZ Camera を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "uvc-ptz-camera": { "command": "uvx", "args": [ "uvc-ptz-camera-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、UVC PTZ Camera のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    UVC PTZ Camera を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が UVC PTZ Camera を使っていると言うか、回答に UVC PTZ Camera のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UVC_PTZ_STATE_DIR 各カメラについて学習した情報を保存する場所です。既定値は /.uvc-ptz-camera-mcp です。角度のみを保持し、認証情報は保持しません。
    英語の原文を見るWhere to store what has been learned about each camera. Defaults to ~/.uvc-ptz-camera-mcp. Holds angles, never credentials.
  • UVC_PTZ_SIM_SOURCE 合成されたパノラマの代わりにシミュレーターのパノラマとして使用する画像へのパス。
    英語の原文を見るPath to an image to use as the simulator's panorama instead of the synthesised one.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server UVC PTZ Camera を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "uvc-ptz-camera": { "type": "stdio", "command": "uvx", "args": [ "uvc-ptz-camera-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、UVC PTZ Camera のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    UVC PTZ Camera を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が UVC PTZ Camera を使っていると言うか、回答に UVC PTZ Camera のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UVC_PTZ_STATE_DIR 各カメラについて学習した情報を保存する場所です。既定値は /.uvc-ptz-camera-mcp です。角度のみを保持し、認証情報は保持しません。
    英語の原文を見るWhere to store what has been learned about each camera. Defaults to ~/.uvc-ptz-camera-mcp. Holds angles, never credentials.
  • UVC_PTZ_SIM_SOURCE 合成されたパノラマの代わりにシミュレーターのパノラマとして使用する画像へのパス。
    英語の原文を見るPath to an image to use as the simulator's panorama instead of the synthesised one.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?UVC PTZ Camera を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user uvc-ptz-camera -- uvx uvc-ptz-camera-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "uvc-ptz-camera": {
      "command": "uvx",
      "args": [
        "uvc-ptz-camera-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "uvc-ptz-camera": {
      "command": "uvx",
      "args": [
        "uvc-ptz-camera-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "uvc-ptz-camera": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "uvc-ptz-camera-mcp"
      ]
    }
  }
}

自分で入力する値

  • UVC_PTZ_STATE_DIR env
    各カメラについて学習した情報を保存する場所です。既定値は /.uvc-ptz-camera-mcp です。角度のみを保持し、認証情報は保持しません。
    英語の原文を見るWhere to store what has been learned about each camera. Defaults to ~/.uvc-ptz-camera-mcp. Holds angles, never credentials.
  • UVC_PTZ_SIM_SOURCE env
    合成されたパノラマの代わりにシミュレーターのパノラマとして使用する画像へのパス。
    英語の原文を見るPath to an image to use as the simulator's panorama instead of the synthesised one.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
82/週
接続方法
パソコンで動く
最新バージョンi
0.2.0
カテゴリi
その他
レジストリ公開日i
2026年10月8日
コードの最終更新i
2026年10月8日
作者
AbhijatSaxena
パッケージ
pypi: uvc-ptz-camera-mcp
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント AbhijatSaxena で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:42 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に uvc-ptz-camera-mcp@0.2.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/abhijatsaxena-uvc-ptz-camera-mcp.svg)](https://mcp.popnx.com/en/servers/abhijatsaxena-uvc-ptz-camera-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20693件のうち0%よりスターが多い
  • このカテゴリのほかの20693件のうち51%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20693件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

UVC PTZ Cameraは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は42 日前、最新バージョン(0.2.0)がレジストリに届いたのは42 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
UVC PTZ Camera
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

uvc-ptz-camera-mcp

An MCP server for USB (UVC) pan/tilt/zoom cameras: aim them, nudge them, sweep them smoothly, zoom, and look through them — with every move confirmed by comparing the picture before and after.

No account, no cloud, no vendor SDK. One device, one USB cable.

camera_status       the camera, its axes and ranges, and whether it is real

aim point an axis at an absolute value, confirmed from the picture nudge move relative to where the device says it is sweep a smooth timed move, streamed at 15 Hz zoom set zoom as a multiplier (1x .. the camera's maximum) recentre every axis back to its default look one frame, returned as an image aim_learn remember "this direction is the desk" aim_list what has been recorded for this camera go_to point at a recorded direction plan_shot compile a multi-step shot and report what it would do, moving nothing run_shot execute a multi-step move, verified after every waypoint mark_view store the current picture under a label check_view has the picture changed since that label? track_start follow a subject: detect, measure, take a step, look again track_status what the follow loop is doing, iteration by iteration track_stop stop following and report what it saw and what it moved

Composing a shot is plan_shot then run_shot. Planning compiles exactly the steps the executor will compile, reports the per-step schedule, how far each axis travels and how long it takes, and touches nothing — so an agent can iterate on "a panorama, then zoom in on me" against the camera's real ranges *before* anything moves, instead of finding out afterwards.

Following

track_start runs a loop that keeps the camera pointed at a subject: detect it, measure how far it is from the centre of the frame, take a bounded step, look again. It decides only from the picture, for the same reason every other move here does — this camera's own report of where it is pointing cannot be trusted. It stops on its own when the subject is lost, when it settles inside the dead zone, when the camera stops answering, or after max_seconds, and track_status lists every iteration with the offset it measured and the step it applied.

Two quantities are *mount*-dependent rather than device-dependent, so they are explicit parameters instead of clever guesses: gain, degrees of movement per pixel of offset, and invert, which flips the direction. A wrong choice shows up honestly as a residual error that grows, and a single iteration is capped at 25 degrees, so a wrong gain converges slowly rather than throwing the camera across its whole range in one command.

Detection uses OpenCV's bundled face cascade (pip install 'uvc-ptz-camera-mcp[tracking]'), which needs no model download, no account and no network at first use. It finds faces: this follows a person, not a car or a dog. The loop and its arithmetic are tested against the simulator, but no part of follow mode has ever run against real hardware — treat it as the least proven thing here.

Why this exists

This class of camera reports positions it never moved to. Measured on the reference device (a DJI Osmo Pocket 4P in webcam mode, over its standard UVC controls):

  • a command to pan to 180 read back `180` while the video proved the camera had not moved at all;
  • a whole 32-second run read back 0 on every sample while the frame demonstrably changed;
  • pan 120 read back 119, pan 200 read back 199.

An agent acting on those values reports moves that never happened. So this server treats every device-reported value as a hint — returned, labelled, never trusted — and decides moved by comparing frames.

The threshold is not a guess either. It was calibrated on labelled hardware frames: every "same view" pair scored ≤ 0.104 (a 96-second quiet baseline, and two commands the hardware ignored), every "view changed" pair scored ≥ 0.624 (a pan, a tilt, a 12× zoom, two aim steps). The shipped threshold is the midpoint, 0.364 — a 6× separation — and the test suite asserts it still separates them. The labelled pairs and the values the metric produced are kept in the repository (tests/fixtures/) so the number can be re-checked rather than believed — as measurements, not pictures: no frame or video taken by a camera is committed here, and a test fails if one appears. The measurements behind the calibration are in docs/measurements.md.

What keeps the agent honest

  • `moved` comes from the picture. device_reported is returned beside it, labelled a hint.
  • A move that produced no change is an error, not a quiet success — after a bounded retry, the tool fails naming what was requested and what was observed.
  • Already being at the target is success without movement: moved: false, no error.
  • Blocking work never runs on the event loop (COM calls, ffmpeg captures), pinned by a test that records which thread the camera was touched on.
  • Observation is explicit: nothing takes a picture except a tool you called.
  • A refused write aborts a shot rather than continuing to drive a camera that stopped listening.

Install

uvx uvc-ptz-camera-mcp            # run without installing

pip install uvc-ptz-camera-mcp # or install it

For a real camera on Windows you also need the DirectShow extras:

pip install "uvc-ptz-camera-mcp[dshow]"

Then point your host at it — --print-config emits the snippet with the right interpreter:

uvc-ptz-mcp --print-config

uvc-ptz-mcp --list-devices # what to pass to --device uvc-ptz-mcp --backend simulator # try it with no camera attached

Where to put it

Claude Desktop, Cursor, VS Code and friends all take the same shape — this is the whole configuration, because there is nothing to authenticate:

{

"mcpServers": { "ptz-camera": { "command": "uvx", "args": ["uvc-ptz-camera-mcp"] } } }

Add "--device", "Osmo" (any substring of the name --list-devices prints) when the machine has more than one camera, and "--backend", "simulator" to work with none. Both can also be set in the environment instead of the args — UVC_PTZ_DEVICE, UVC_PTZ_BACKEND and UVC_PTZ_STATE_DIR — which is what the Claude Desktop bundle uses, and which survives a host restart without editing its config again. A flag wins over the environment, and an empty value means "not set" (a host that leaves an option blank writes "", not nothing). Claude Desktop also accepts the .mcpb bundle attached to each release as a one-click install.

Modes, and how you can tell which one you are in

BackendWhat it is
auto (default)Prefer a real camera; fall back to the simulator, saying why
dshowWindows DirectShow: the real device path
simulatorNo hardware at all: a model calibrated from the measurements below

Every result carries "simulated": true or false, and camera_status reports the reason when the simulator is standing in. Nothing quietly pretends to be hardware: a caller must never believe it is driving a camera when it is driving a model.

The simulator is calibrated from the reference device, not invented: ~0.4 s from write to first motion, a pan completing in about a second, a 4× zoom in about 2.5 s, silently dropped writes, and a read-back that echoes a request the hardware never applied. It renders frames by cropping a wide panorama, so a simulated pan genuinely changes the pixels — a simulator with a static picture would let verification pass vacuously.

Honest limitations

  • The real-device path is Windows-only (DirectShow). A Linux backend would use v4l2; the interface is in place, the implementation is not written.
  • No exposure, focus or white balance. The reference camera exposes no Processing Unit at all — only pan/tilt/roll/zoom.
  • The vendor Extension Unit is unreachable on Windows, so features that live there (on the reference camera, its built-in subject tracking) cannot be driven from software. Measured: IKsControl is refused on the device filter, IKsTopologyInfo lists three nodes and no vendor node, and CreateNodeInstance fails on all of them. Linux can reach it through uvcvideo's UVCIOC_CTRL_QUERY; that is a separate backend.
  • A moving subject looks like a moving camera. Frame comparison cannot tell the two apart; the metric is calibrated so that a static scene behaves, and check_view is there for judging a view rather than a move.
  • One unusable device must not hide the others. A registered-but-unavailable virtual camera raised when its DirectShow moniker was bound, which aborted a listing that should have returned two working cameras. Enumeration now skips what it cannot load and says so, and the same rule applies inside the backend when it looks for the camera you named.
  • Measured latency sets the ceiling: ~0.4 s from command to motion, so control loops run at a couple of hertz, not tens. That is the hardware's floor, not the software's.
  • The DirectShow path is tested but dormant. The reference device was returned partway through development, so the hardware path is exercised up to its interface and typed correctly against it, while the simulator carries the test load. Treat the first run against a real camera as the true acceptance test.

Development

pip install -e ".[dshow]" numpy pytest pytest-asyncio ruff

python -m pytest -q # 39 tests, three layers python -m ruff check . && python -m ruff format --check .

The suite is layered deliberately: the tool surface in-process against the simulator (mapping, validation, honest failure), pure unit tests for the compiler and the metric, and a real stdio handshake as a subprocess — including one run with a device name that cannot exist, because a server that dies at startup is invisible to every host and directory that lists it.

Reference device

Built against a DJI Osmo Pocket 4P in webcam mode: VID_2CA3 / PID_0023, exposing pan −38…215°, tilt −33…105°, roll ±35°, zoom 100…1200 (1×–12×) as standard UVC camera controls. Any UVC PTZ camera exposes the same surface; the ranges are read from the device at startup rather than assumed, and nothing vendor-specific is hard-coded.

Not affiliated with, endorsed by, or supported by DJI.