kallistox/mcp-unifi-applications

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

40 stars 6 forks Качество 85 Тренд 26MIT

Обзор

Сервер MCP, который предоставляет документацию API приложения UniFi (Network, Protect, Site Manager) в качестве запрашиваемых инструментов для Claude Desktop, Claude Code (VS Code / JetBrains) или любого MCP-совместимого клиента. Включает скребок на основе Playwright, который превращает SPA-доки JS-рендеринга в структурированные файлы JSON и сервер MCP Python, который их обслуживает. Можете ли вы рассказать мне, как создать сеть с помощью Go с сетевым API от UniFi и какие у меня есть варианты в отношении управляемой конфигурации шлюза IPv4 DHCP? Клод автоматически запрашивает сервер MCP - поиск конечных точек, извлечение схем и сверление в вариантах дискриминатора - затем отвечает полными деталями API и рабочим примером Go: Скребок работает внутри Docker (требуется Playwright/Chromium): Предварительно обработанные документы включают: Network API v10.3.58 (docs/network/), Protect v7.1.87 (docs/protect/), Site Manager v1.0.0 (docs/site-manager/). Каждое приложение содержит meta.json (версия API, дата скрапа, количество страниц).

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), который делает официальную документацию UniFi API запрашиваемой агентами ИИ — поиск конечных точек, сверление схемы и примеры кода на пяти языках для Claude Desktop, Claude Code (VS Code / JetBrains) или любого MCP-совместимого клиента.

Охватывает каждое приложение Ubiquiti публикует API-документы для: Сеть, Защита, Менеджер сайтов, Внутреннее пространство, Мобильность и Ткань Перевозчика.

Это **только для чтения и без учетных данных **: он обслуживает документацию, он не разговаривает с вашим контроллером. Включает скребок на основе Playwright, который превращает SPA в структурированный JSON, и сервер Python MCP, который его обслуживает.

Пример

Без какого-либо контекста, просто используя MCP-сервер Unifi-приложений: Расскажите мне, как создать сеть с помощью Go с сетевым API от UniFi. Какие опции у меня есть в отношении управляемой конфигурации шлюза IPv4 DHCP?

Клод работает через сервер, не имея ни одной документации. Контекст для начала:

Позвоните. Что возвращается [скрыто] [скрыто] [[Т1]] [[Т1]] [[Т1]]][[Т1]]

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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]:

Открыть полный README на GitHub

Установка

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"
    }
  }
}