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

Unifi MCP

作者:mikeholownychバージョン 0.8.2i★ 2iパソコンで動くリポジトリ ↗
レジストリ名io.github.mikeholownych/unifi-mcp

インストール方法

What it does

MCP server for Ubiquiti UniFi Network and Protect. 63 tools, 16 agent skills.

  • Connects パソコンで動く
  • Account or key Needs UNIFI_PASSWORD · 1 setting to fill in (UNIFI_DEVICES)
  • Category その他

この順位の理由

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

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

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

インストール

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

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

Unifi MCP をインストールして。https://mcp.popnx.com/i/mikeholownych-unifi-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

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

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

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

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

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

Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

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

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

このパソコンの Claude に MCP server Unifi MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "unifi": { "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_PASSWORD, UNIFI_DEVICES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Unifi MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. Unifi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • UNIFI_DEVICES UniFi デバイス設定の JSON 配列(name、url、api_key、services、site)。
      英語の原文を見るJSON array of UniFi device configs (name, url, api_key, services, site)

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

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

    SettingsDeveloperEdit Config

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

    {
      "mcpServers": {
        "unifi": {
          "command": "uvx",
          "args": [
            "mcp-unifi"
          ],
          "env": {
            "UNIFI_DEVICES": "your-value",
            "UNIFI_PASSWORD": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

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

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

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

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

  • UNIFI_MODE 認証モード: local(セッション)、local_api_key(Integration API)、または cloud
    英語の原文を見るAuth mode: local (session), local_api_key (Integration API), or cloud
  • UNIFI_USERNAME セッション認証用のコントローラーのユーザー名 (UNIFI_MODE=local)
    英語の原文を見るController username for session auth (UNIFI_MODE=local)
  • UNIFI_VERIFY_SSL SSL 証明書を検証します(自己署名の場合は false)
    英語の原文を見るVerify SSL certificates (false for self-signed)

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

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

ChatGPT はまだ Unifi MCP につなげません

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

代わりにできること

A · Unifi MCP につなげるアプリを使う

  • Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

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

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

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

Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

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

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

このパソコンの Claude Code に MCP server Unifi MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifi 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_PASSWORD, UNIFI_DEVICES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Unifi MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. Unifi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • UNIFI_DEVICES UniFi デバイス設定の JSON 配列(name、url、api_key、services、site)。
      英語の原文を見るJSON array of UniFi device configs (name, url, api_key, services, site)

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

  4. ターミナルを開く

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

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

    claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifi

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

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

  7. 試してみる

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

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

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

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

  • UNIFI_MODE 認証モード: local(セッション)、local_api_key(Integration API)、または cloud
    英語の原文を見るAuth mode: local (session), local_api_key (Integration API), or cloud
  • UNIFI_USERNAME セッション認証用のコントローラーのユーザー名 (UNIFI_MODE=local)
    英語の原文を見るController username for session auth (UNIFI_MODE=local)
  • UNIFI_VERIFY_SSL SSL 証明書を検証します(自己署名の場合は false)
    英語の原文を見るVerify SSL certificates (false for self-signed)

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

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

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

Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

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

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

このパソコンの Cursor に MCP server Unifi MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "unifi": { "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_PASSWORD, UNIFI_DEVICES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Unifi MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. Unifi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • UNIFI_DEVICES UniFi デバイス設定の JSON 配列(name、url、api_key、services、site)。
      英語の原文を見るJSON array of UniFi device configs (name, url, api_key, services, site)

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

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

    Cursor で開く

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

  5. キーを入力

    Unifi MCP の設定で UNIFI_PASSWORD, UNIFI_DEVICES が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

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

  7. 試してみる

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

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

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

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

  • UNIFI_MODE 認証モード: local(セッション)、local_api_key(Integration API)、または cloud
    英語の原文を見るAuth mode: local (session), local_api_key (Integration API), or cloud
  • UNIFI_USERNAME セッション認証用のコントローラーのユーザー名 (UNIFI_MODE=local)
    英語の原文を見るController username for session auth (UNIFI_MODE=local)
  • UNIFI_VERIFY_SSL SSL 証明書を検証します(自己署名の場合は false)
    英語の原文を見るVerify SSL certificates (false for self-signed)

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

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

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

Unifi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (UNIFI_DEVICES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

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

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

このパソコンの VS Code に MCP server Unifi MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "unifi": { "type": "stdio", "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_PASSWORD, UNIFI_DEVICES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Unifi MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. Unifi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • UNIFI_DEVICES UniFi デバイス設定の JSON 配列(name、url、api_key、services、site)。
      英語の原文を見るJSON array of UniFi device configs (name, url, api_key, services, site)

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

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

    VS Code で開く

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

  5. キーを入力

    Unifi MCP の設定で UNIFI_PASSWORD, UNIFI_DEVICES が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

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

  7. 試してみる

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

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

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

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

  • UNIFI_MODE 認証モード: local(セッション)、local_api_key(Integration API)、または cloud
    英語の原文を見るAuth mode: local (session), local_api_key (Integration API), or cloud
  • UNIFI_USERNAME セッション認証用のコントローラーのユーザー名 (UNIFI_MODE=local)
    英語の原文を見るController username for session auth (UNIFI_MODE=local)
  • UNIFI_VERIFY_SSL SSL 証明書を検証します(自己署名の場合は false)
    英語の原文を見るVerify SSL certificates (false for self-signed)

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

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

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

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

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

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

パソコンにインストール

Claude Code

claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifi

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "mcp-unifi"
      ],
      "env": {
        "UNIFI_DEVICES": "your-value",
        "UNIFI_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "mcp-unifi"
      ],
      "env": {
        "UNIFI_DEVICES": "your-value",
        "UNIFI_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "unifi": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-unifi"
      ],
      "env": {
        "UNIFI_DEVICES": "your-value",
        "UNIFI_PASSWORD": "your-value"
      }
    }
  }
}

自分で入力する値

  • UNIFI_DEVICES 必須 env
    UniFi デバイス設定の JSON 配列(name、url、api_key、services、site)。
    英語の原文を見るJSON array of UniFi device configs (name, url, api_key, services, site)
  • UNIFI_MODE env
    認証モード: local(セッション)、local_api_key(Integration API)、または cloud
    英語の原文を見るAuth mode: local (session), local_api_key (Integration API), or cloud
  • UNIFI_USERNAME env
    セッション認証用のコントローラーのユーザー名 (UNIFI_MODE=local)
    英語の原文を見るController username for session auth (UNIFI_MODE=local)
  • UNIFI_PASSWORD 秘密 必須 env
    セッション認証用のコントローラーのパスワード (UNIFI_MODE=local)
    英語の原文を見るController password for session auth (UNIFI_MODE=local)
  • UNIFI_VERIFY_SSL env
    SSL 証明書を検証します(自己署名の場合は false)
    英語の原文を見るVerify SSL certificates (false for self-signed)

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

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

ひと目でわかる

週あたりのダウンロードi
21/週
接続方法
パソコンで動く
最新バージョンi
0.8.2
カテゴリi
その他
レジストリ公開日i
2026年8月26日
コードの最終更新i
2026年10月25日
作者
mikeholownych
パッケージ
pypi: mcp-unifi
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。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アカウント mikeholownych で確認済みです

  • ✓ 合格

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

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

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

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

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

  • – 対象外

    OAuthでサインイン

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

  • … 未チェック

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

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

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

OSV.dev に mcp-unifi@0.8.2 の登録はありません

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

確認していること → · JSON

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

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

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mikeholownych-unifi-mcp.svg)](https://mcp.popnx.com/en/servers/mikeholownych-unifi-mcp)

話し合い

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

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

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

ログインして投稿

ユーザーレビュー

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

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

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

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

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

よくある質問

Unifi MCPは安全ですか?

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

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

入力が必要なもの:UNIFI_PASSWORD

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

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

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

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

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

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
似たものと比べる
これ
Unifi MCP
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、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

UniFi MCP Server

mcp-name: io.github.mikeholownych/unifi-mcp

An MCP (Model Context Protocol) server that provides AI assistants like Claude with access to UniFi Network and Protect infrastructure management and analysis capabilities. It uses the native MCP SDK 2 MCPServer API (not FastMCP 3) and communicates over stdio by default.

Credits: This project started as a fork of gbassaragh/Unifi-mcp and has since evolved into a fully independent project. Thanks to @gbassaragh for the excellent starting point.

Improvements Over Upstream

  • Fixed local session authentication routing — in UNIFI_MODE=local, requests now correctly use the traditional controller API (/proxy/network) with cookie + CSRF session auth. Upstream always routed through the Integration API regardless of mode.
  • Mode-aware base URL resolution — api_base_url now respects the configured auth mode instead of unconditionally returning the Integration API endpoint.
  • Expanded test suite — 250+ passing tests covering configuration, MCP compatibility, runtime persistence, network client behavior, server tool registration, and Protect integrations.

Features

UniFi Network
  • Device Management: List, restart, locate, and upgrade UniFi devices (APs, switches, routers)
  • Client Management: Monitor connected clients, block/unblock, view traffic statistics
  • Site Management: View site health, network configurations, VLANs, and wireless settings
  • Statistics & Monitoring: Events, alarms, speed tests, and DPI statistics
  • AI-Powered Insights: Network analysis, optimization recommendations, and troubleshooting
UniFi Protect
  • Camera Management: List cameras, view status, get live snapshots
  • System Monitoring: NVR status, camera health summaries
  • Accessories: Manage lights, sensors, chimes, and viewers
  • Liveviews: Access configured camera view layouts
Multi-Device Support
  • Configure multiple UniFi devices (gateways, NVRs, etc.)
  • Target specific devices by name — all network and Protect tools accept an optional device parameter
  • Per-device API keys: each configured device authenticates with its own key
  • Mix of Network and Protect services across devices
Events and Safe Automation
  • Normalize and durably deduplicate Network and Protect events in optional SQLite storage
  • Poll each configured source independently and report unsupported capabilities explicitly
  • Run only built-in interval jobs: poll_events, retry_webhook_deliveries, capture_observations, and prune_runtime_data
  • Deliver filtered, signed HTTPS webhooks with bounded retries and dead-letter state
  • Keep persistence, background automation, and private webhook destinations disabled by default
Authentication Modes
ModeAuthBest for
local_api_keyIntegration API keyRecommended default; broad read access
localUsername/password sessionFull feature access: firewall rules, WLAN configs, site settings, events, alarms, DPI
cloudapi.ui.com keyRemote/cloud-managed controllers

When API keys are used (Integration API), a subset of controller features is only available via legacy session auth (UNIFI_MODE=local): network events, alarms, DPI statistics, speed tests, WLAN configs, firewall rules, port profiles, and routing tables. Tools for these features return a clear error explaining how to enable them rather than failing silently. Insight tools degrade gracefully and report data limitations.

Note on local accounts: SSO/Ubiquiti-account admins protected by MFA cannot complete session login. Create a local admin on your console (*Restrict to Local Access Only*) for UNIFI_MODE=local.

Agent Skills

Bundled skills (in skills/) teach agents proven workflows for this server — including controller-specific gotchas (Network 10 removed endpoints, zone-pair rules, WPA3 transition).

Full documentation: See SKILLS.md for usage guide, expected results, troubleshooting, and how to request new functionality.

Quick reference
SkillTypePurpose
unifi-network-auditread-onlyFull site audit: devices, clients, WiFi posture, firewall, structured report
unifi-troubleshoot-clientread-onlyDiagnose a misbehaving device: RF, roaming, blocking, IP layer
unifi-wifi-optimizewrite-gatedChannel plan, widths, WPA3 transition, band steering — approval-gated
unifi-grant-device-accesswrite-gatedGive a device a reserved IP + scoped zone-firewall access
unifi-internet-downread-only triage"Internet is dead!" — plain-English outage diagnosis, ISP escalation script
unifi-whos-homeread-only"Who's on my WiFi?" — friendly inventory, intruder checks with randomized-MAC awareness
unifi-setup-new-devicewrite-gatedGet any new gadget online: pairing pitfalls (2.4GHz/WPA3), naming, IP reservation
unifi-dns-triageread-only"Site won't load but ping works" — resolution vs connectivity split, forced-internal-DNS patterns
unifi-mdns-discoveryread-only+AirPrint/Cast broken across VLANs — mDNS reflection, IGMP/IPTV cautions
unifi-port-forwardingwrite-gatedSelf-hosted service exposure incl. hairpin NAT, CGNAT detection, zone-policy pairing
unifi-vpnwrite-gatedWireGuard/Teleport setup + failure ladder (handshake/MTU/zone-policies)
unifi-firmware-campaignwrite-gatedStaged firmware updates: snapshot, canary, verify, stuck-device ladder
unifi-mesh-backhaulread-onlySlow far-room WiFi: wireless-uplink/hop diagnosis, wired-backhaul guidance
unifi-ids-ips-triageread-only+Threat alerts: false-positive vs real, suppression, IPS throughput cost
unifi-backup-migrationwrite-gatedWhat backups contain, migration rules of thumb, pre-migration snapshots
unifi-network-mapdoc-writerPersistent labeled topology (zones/VLANs/deps) that sharpens every other skill
How skills work

Just describe your problem naturally — the agent matches your request to the right skill and follows its workflow:

  • "My internet is down" → unifi-internet-down diagnoses WAN, modem, gateway
  • "Who's on my WiFi?" → unifi-whos-home lists devices, flags unknowns
  • "Audit my network" → unifi-network-audit produces a full health report
  • "Set up my new TV" → unifi-setup-new-device guides WiFi pairing

Write-gated skills (marked above) modify your network — they always ask approval before applying changes.

Skills for non-technical users avoid jargon, translate every technical term, and require confirmation before disruptive actions.

Install (per project): copy into .claude/skills/:

git clone https://github.com/mikeholownych/unifi-mcp.git

mkdir -p .claude/skills && cp -r unifi-mcp/skills/* .claude/skills/

See SKILLS.md for full usage guide, expected results, troubleshooting, and how to request new functionality.

Skills reference MCP tools by their plain names (get_firewall_policies, …); your MCP client prefixes them automatically.

Supported Hardware

  • UniFi Dream Machine (UDM, UDM-Pro, UDM-SE)
  • UniFi Cloud Gateway (UCG-Ultra, UCG-Fiber)
  • UniFi Network Video Recorder (UNVR, UNVR-Pro)
  • UniFi Network Application (self-hosted)
  • Traditional Cloud Key (Gen1, Gen2, Gen2+)

Limitations & Supported Versions

This server is built for operation on a trusted local network, talking to UniFi consoles by IP address. With that in mind:

  • TLS verification is disabled by default (UNIFI_VERIFY_SSL=false). UniFi OS ships self-signed certificates, and controllers are reached by IP on the LAN, so certificate verification is expected to fail. Enable UNIFI_VERIFY_SSL=true only when your controller presents a CA-trusted certificate.
  • No device configured at startup is allowed. The server boots and exposes all tools even before UNIFI_* credentials are supplied (e.g. when deployed and configured via environment variables). Device-bound tool calls then return a clear No device configured error until a device is set.
  • Scope enforcement applies to remote transports only. When running over Streamable HTTP, every tools/call is gated by read/write/admin OIDC scopes, and startup fails if any tool is unclassified. Over stdio (local IPC) no auth is required — stdio is assumed to be a trusted local process.
  • Integration API key limitations. A subset of controller features is only available via legacy session auth (UNIFI_MODE=local): network events, alarms, DPI statistics, speed tests, WLAN/firewall configs, port profiles, and routing tables. Tools for these return a clear error explaining how to enable them.
  • Tested against recent UniFi OS / Network / Protect. Newer controllers that removed legacy endpoints (e.g. UniFi Network 10 removed alarms/events endpoints) are handled by degrading gracefully rather than erroring.
  • Not a substitute for controller backups. Snapshots and reports are read-only exports; they do not configure or restore a controller.

Installation

Using uv (Recommended)
# Clone the repository

git clone https://github.com/mikeholownych/unifi-mcp.git cd unifi-mcp

Install dependencies

uv sync

Using pip
pip install -e .

Configuration

Create a .env file in the project root (or set environment variables). See .env.example for all options.

UNIFI_CACHE_TTL controls the shared GET cache lifetime across client instances (default: 30 seconds). Mutation verification defaults to five fresh reads with exponential delays of 0.5, 1, 2, and 2 seconds. Tune this with UNIFI_MUTATION_VERIFY_ATTEMPTS, UNIFI_MUTATION_VERIFY_INITIAL_DELAY, and UNIFI_MUTATION_VERIFY_MAX_DELAY when a controller converges more slowly or quickly.

Optional Runtime Persistence

SQLite-backed runtime persistence is disabled by default. Enable it only when persistent runtime state is needed:

UNIFI_RUNTIME_ENABLED=true

By default, the database is runtime.db under UNIFI_DATA_DIR. If UNIFI_DATA_DIR is not set, the server follows the XDG data convention: $XDG_DATA_HOME/unifi-mcp when XDG_DATA_HOME is an absolute path, otherwise ~/.local/share/unifi-mcp. The resulting default database is therefore $XDG_DATA_HOME/unifi-mcp/runtime.db or ~/.local/share/unifi-mcp/runtime.db.

Set an explicit data directory or database path when needed:

UNIFI_DATA_DIR=/var/lib/unifi-mcp

UNIFI_RUNTIME_DATABASE=/var/lib/unifi-mcp/runtime.db

UNIFI_DATA_DIR and UNIFI_RUNTIME_DATABASE must resolve to absolute paths. UNIFI_RUNTIME_DATABASE overrides the database derived from UNIFI_DATA_DIR.

Events, Schedules, and Webhooks

Runtime persistence enables event storage and management tools, but does not start background work. Enable the scheduler separately:

UNIFI_RUNTIME_ENABLED=true

UNIFI_AUTOMATION_ENABLED=true

Event ingestion is capability-based polling, not a claim of universal UniFi push support:

  • Network event polling requires traditional local session auth with UNIFI_MODE=local.
  • Protect event polling requires a configured local username and password for e

冒頭だけを表示しています。続きはリポジトリで読めます