KM

kallistox/mcp-unifi-applications

Browser automation

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

40 stars 6 forks 品質 85 トレンド 26MIT

Claude Desktop、Claude Code(VSコード/JetBrains)、MCP互換クライアントのクエリ可能なツールとして、UniFi アプリケーション API のドキュメント(ネットワーク、保護、サイトマネージャ)を公開するMCPサーバー.

概要

Claude Desktop、Claude Code(VSコード/JetBrains)、MCP互換クライアントのクエリ可能なツールとして、UniFi アプリケーション API のドキュメント(ネットワーク、保護、サイトマネージャ)を公開するMCPサーバー。 JS レンダリングされた docs SPA を構造化された JSON ファイルに変える Playwright ベースのスクレーパーと、それらを提供する Python MCP サーバーが含まれています。 「UniFi からネットワーク API と、管理された IPv4 DHCP ゲートウェイ構成に関するオプションで Go でネットワークを作成する方法を教えてください。」 Claude は MCP サーバーを自動的に問い合わせます。エンドポイントの検索、スキーマの取得、およびディスクリミネーターのバリアントへの穴あけ — では、API の詳細と作業中の Go の例をフルで処理します。 スクレーパーは Docker 内で実行します( Playwright/Chromium が必要です): プリスクレイド・ドキュメントには、ネットワーク API v10.3.58 (docs/network/)、保護 v7.1.87 (docs/protect/)、サイト・マネージャー v1.0.0 (docs/site-manager/) が含まれます。 各アプリの dir は meta.json (API バージョン、スクレイプ日付、ページ数) を実行します.

概要(AI 翻訳)

AIエージェントがクエリ可能な公式のUniFi APIドキュメントを作成するモデルコンテキストプロトコル(MCP)サーバー — エンドポイント検索、スキーマドリルダウン、Claudeデスクトップ、Claudeコード(VSコード/JetBrains)、またはMCP互換クライアントの5つの言語のコード例。

Ubiquiti は、全てのアプリケーションに API ドキュメントを公開しています。Network、Protect、Site Manager、InnerSpace、Mobility、キャリアファブリック。

read-only と credential-free* です: ドキュメンテーション機能で、管理者には話しません。 JS レンダリングされた docs SPA を構造化された JSON に変える Playwright ベースのスクレーパーと、それをサポートする Python MCP サーバーが含まれています。

例

「unifi-applications MCP Server を使用するだけで、任意のコンテキストを使用すれば、 UniFi からネットワーク API を使ってネットワークを作成する方法を教えてください。 管理されたIPv4 DHCPゲートウェイ構成に関するオプションは?

Claude は、サーバーを経由して、そのドキュメントのどれも、そのサーバーを経由して動作します。 コンテキスト:

| お問い合わせ | 新着情報 | お問い合わせ | [search_endpoints("create network") | [POST /v1/sites/{siteId}/networks |[POST /v1/sites/{siteId}/networks |[[POST /v1/sites/{siteId}/networks] |[[[POST /v1/sites/{siteId}/networks]] |[[POST /v1/sites/{siteId}/networks]] |[[POST /v1/sites/{siteId}/networks]]] |[[[[[[POST /v1/sites/{siteId}/networks]]]] [[[[POST /v1/sites/{siteId}/networks]]]]]] [[[[[POST /v1/sites/{siteId}/networks]]]]]]] [[[[POST /v1/sites/{siteId}/networks]]]]]]

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

UniFi MCP Server — Queryable API Documentation

A Model Context Protocol (MCP) server that makes the official UniFi API documentation queryable by AI agents — endpoint search, schema drill-down, and code examples in five languages, for Claude Desktop, Claude Code (VS Code / JetBrains), or any MCP-compatible client.

Covers every application Ubiquiti publishes API docs for: Network, Protect, Site Manager, InnerSpace, Mobility and Carrier Fabric.

It is read-only and credential-free: it serves documentation, it does not talk to your controller. Includes a Playwright-based scraper that turns the JS-rendered docs SPA into structured JSON, and a Python MCP server that serves it.

Example

“Without any context, just by using the unifi-applications MCP Server: can you tell me how to create a network with Go with the network API from UniFi, and what options do I have regarding the managed IPv4 DHCP gateway configuration?”

Claude works that out through the server, with none of the documentation in its context to begin with:

Call What comes back
search_endpoints("create network") POST /v1/sites/{siteId}/networks
get_endpoint("network/createnetwork") the request body — management is a discriminated union
get_field_schema(…, "management[GATEWAY].ipv4Configuration.dhcpConfiguration") only the DHCP subtree
get_example("network/createnetwork", "go") a working request in Go

The third call is the one that earns the server its place. It returns this, and nothing else — not the 70 KB endpoint schema it is buried in:

# management[GATEWAY].ipv4Configuration.dhcpConfiguration (in requestBody)
- dhcpConfiguration: object (Gateway Managed IPv4 DHCP Configuration) — IPv4 DHCP
  configuration for this network. If omitted or null, DHCP is not working and hosts
  must get an address statically or from another server in this broadcast domain.
  - mode: string (required)
    [RELAY]:
GitHub で README 全文を見る

インストール

docker run --rm -v "$(pwd)/src/mcp_unifi_applications/docs:/output" unifi-scraper node scrape.mjs
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "unifi-docs": { "type": "stdio", "command": "mcp-unifi-applications" } } }