kallistox/mcp-unifi-applications
Browser automation이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP 서버는 Claude Desktop, Claude Code (VS Code / JetBrains) 또는 MCP 호환 클라이언트에 대한 쿼리 가능한 도구로 UniFi 애플리케이션 API 문서 (네트워크, 보호, 사이트 관리자)를 노출시킵니다.
개요
MCP 서버는 Claude Desktop, Claude Code (VS Code / JetBrains) 또는 MCP 호환 클라이언트에 대한 쿼리 가능한 도구로 UniFi 애플리케이션 API 문서 (네트워크, 보호, 사이트 관리자)를 노출시킵니다. JS-rendered docs SPA를 구조화한 JSON 파일로 변환하는 Playwright 기반의 스크레이퍼를 포함하고, Python MCP 서버는 그 역할을 합니다. "UnFi에서 네트워크 API로 이동하고 관리 된 IPv4 DHCP 게이트웨이 구성에 대해 어떤 옵션이 있습니까? Claude는 MCP 서버를 자동으로 쿼리합니다. - endpoints, fetching schemas를 검색하고, Discriminator 변형으로 훈련 - 다음 전체 API 세부 정보와 작업 이동 예제에 응답합니다. 스크레이퍼는 Docker 내부 실행 (Playwright/Chromium 필요): Pre-scraped docs는 다음과 같습니다. Network API v10.3.58 (docs/network/), v7.1.87 (docs/protect/), Site Manager v1.0.0 (docs/site-manager/). 각 앱 dir는 meta.json (API 버전, 스크랩 날짜, 페이지 수)를 나릅니다.
개요(AI 번역)
A Model Context Protocol (MCP) 서버는 AI Agent - 엔드포인트 검색, 스키마 드릴다운, 그리고 Claude Desktop, Claude Code (VS Code / JetBrains) 또는 MCP 호환 클라이언트의 공식 UniFi API 문서 쿼리를 만드는 서버입니다.
모든 응용 프로그램 Ubiquiti는 API docs를 게시합니다. 네트워크, Protect, Site Manager, InnerSpace, Mobility 및 Carrier Fabric.
read-only 및 credential-free: 그것은 문서, 그것은 당신의 관제사에 대화하지 않습니다. JS-rendered docs SPA를 구조화한 JSON으로 변환하는 Playwright 기반의 스크레이퍼를 포함하고, Python MCP 서버를 제공합니다.
예
"무작용 없이, 다만 unifi-applications MCP 서버를 사용하여: 당신은 할 수 있습니다 UniFi에서 네트워크 API로 이동하는 방법을 알려주세요. 관리된 IPv4 DHCP 게이트웨이 구성에 대해 어떤 옵션이 있습니까?
Claude는 서버를 통해 작동하며 문서의 아무도 없습니다. 시작하려면:
| 전화 | 다시 오는 것 |
|—|||
| search_endpoints("create network") | 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]:설치
docker run --rm -v "$(pwd)/src/mcp_unifi_applications/docs:/output" unifi-scraper node scrape.mjs설정
{
"mcpServers": {
"unifi-docs": {
"type": "stdio",
"command": "mcp-unifi-applications"
}
}
}