diff --git a/docs/teilprojekte.md b/docs/teilprojekte.md index d543241..912036b 100644 --- a/docs/teilprojekte.md +++ b/docs/teilprojekte.md @@ -39,15 +39,14 @@ Kontrolle: MikroMCP (MikroTik) live · ALLNET = Klickanleitungen (inline) · Oma ### TP2 — Omada Access-Switch + Controller ▸ 🔄 IN ARBEIT (2026-06-15) - ✅ Omada Controller 6.2.10.17 auf DS923 (macvlan `.175`): `omada/docker-compose.yml`, Stack via Portainer endpointId=14. **Wizard abgeschlossen** (configured=true), Creds in `mcp/omada/.env`. - ✅ pve-mcp (samik081) in Claude Code eingetragen (`~/.claude/settings.json`, SSE `.173:3000`). -- ✅ omada-mcp Container deployed auf **pve-LXC (`.126`, endpointId=2), ipvlan-IP `.176`**, in `~/.claude/settings.json` eingetragen. **Aktuell gestoppt** (Crash-Loop). - - ⚠️ **Erkenntnis:** `jmtvms/tplink-omada-mcp` nutzt die **Omada OPEN API** (`OMADA_CLIENT_ID/SECRET/OMADAC_ID/SITE_ID`), **nicht** User/Passwort. `.env`-Schema entsprechend angepasst. - - ⚠️ Admin-API-Login (admin / Wizard-PW) gibt `-30109` → im UI verifizieren. - **Noch offen (Reihenfolge):** - 1. Controller-UI https://10.40.41.175:8043 → Settings → Platform Integration → **Open API** → App anlegen (Grant: Client Credentials) → Client ID + Secret notieren - 2. `OMADA_SITE_ID` holen (UI oder `GET /{omadacId}/api/v2/sites`) - 3. `mcp/omada/.env` befüllen (CLIENT_ID/SECRET/SITE_ID) → Container neu starten (Portainer Stack `omada-mcp`, Id=200) - 4. SSE-Test `http://10.40.41.176:3000/health` → Claude Code reload → omada-mcp Tools verfügbar - 5. VLANs 10/20/30/40/50/90/99/100 anlegen → `.12` adoptieren → Port 2 (ap2) + Uplink → Trunk-All, Rest → Access VLAN10 +- ✅ omada-mcp **live** auf **pve-LXC (`.126`, endpointId=2), ipvlan-IP `.176`**, Stack Id=200, in `~/.claude/settings.json`. + - **Transport:** StreamableHTTP `http://10.40.41.176:3000/mcp` (Health `/health` → 200, MCP-Handshake verifiziert). + - **Auth:** Omada **Open API Client-Credentials** (NICHT User/PW). Env: `MCP_SERVER_USE_HTTP/MCP_HTTP_*` + `OMADA_BASE_URL/OMADAC_ID/SITE_ID/CLIENT_ID/CLIENT_SECRET/STRICT_SSL`. Creds in `mcp/omada/.env`. + - ⚠️ Open-API-App wurde im Controller-UI angelegt (User); omadac_id=`adbef8fa…`, site_id=`6a2fe68e…`. + **Noch offen:** + 1. Claude Code reload → omada-mcp Tools (84 Tools, read-categories) verfügbar + 2. VLANs 10/20/30/40/50/90/99/100 anlegen → `.12` adoptieren → Port 2 (ap2) + Uplink → Trunk-All, Rest → Access VLAN10 + (Hinweis: geladene Tool-Categories sind aktuell **read-only** — für VLAN/Port-Writes ggf. `OMADA_TOOL_CATEGORIES` um write-Scopes erweitern.) - ✅ Port-Plan: Omada-Switch Port 2 = ap2 (Trunk all), Uplink-Port (→ ALLNET GE8) = Trunk all. - ✅ Portainer-Ablösung: **Komodo** empfohlen (einzige Option mit nativem MCP `mcp-server-komodo`). Eigener Task. - Abh. erfüllt: TP1 (GE8 Trunk ✅). diff --git a/mcp/INVENTORY.md b/mcp/INVENTORY.md index 6f3d14d..9183516 100644 --- a/mcp/INVENTORY.md +++ b/mcp/INVENTORY.md @@ -10,7 +10,7 @@ |---|---|---|---|---|---|---| | **MikroMCP** (AliKarami) | MikroTik hAP ax² ap1/ap2 (RouterOS 7) — WLAN/CAPsMAN, später Router-Cutover | **jetzt: lokal (dieser Mac)** / Ziel: Mac mini `.167` Docker | jetzt **stdio** (`npx mikromcp serve`) / Ziel HTTP `:3000` | `ghcr.io/alikarami/mikromcp:latest` (HTTP) bzw. npm `mikromcp` (stdio) | `mcp/mikromcp/` + Claude-Code user-config | 🟢 **live (stdio), doctor 12/12, in Claude Code ✓Connected** | | **pve-mcp** (samik081) | Proxmox VE API (Host `.100`) | DS923 (`.10`), macvlan-IP **`.173`** | SSE `http://10.40.41.173:3000/sse` | `ghcr.io/samik081/mcp-pve:latest` | — (Stack via Portainer) | 🟢 **live, in Claude Code eingetragen** | -| **omada-mcp** (jmtvms) | TP-Link Omada Controller → ES208G (+ künftige Omada-Geräte) | **pve-LXC (`.126`, endpointId=2)**, ipvlan-IP **`.176`** | SSE `http://10.40.41.176:3000/sse` (`MCP_TRANSPORT=sse`) | `jmtvms/tplink-omada-mcp:latest` | `mcp/omada/` ✓, in settings.json ✓ | 🟠 **Container deployed (gestoppt) — braucht Open-API-Client-Creds (UI: Platform Integration → Open API). User/PW funktioniert NICHT, nur Client-Credentials.** | +| **omada-mcp** (jmtvms v0.15) | TP-Link Omada Controller → ES208G (+ künftige Omada-Geräte) | **pve-LXC (`.126`, endpointId=2)**, ipvlan-IP **`.176`** | **StreamableHTTP** `http://10.40.41.176:3000/mcp` (Health `/health`) | `jmtvms/tplink-omada-mcp:latest` | `mcp/omada/` ✓, settings.json ✓ | 🟢 **live (Up, /health 200, MCP-Handshake ✓). Auth = Omada Open API Client-Credentials. Tools nach Claude-Code-Reload.** | | **omada-controller** | Omada Software Controller (keine MCP) | DS923 (`.10`), macvlan-IP **`.175`** | HTTPS `https://10.40.41.175:8043` | `mbentley/omada-controller:6.2` | `omada/docker-compose.yml` | 🟢 **live, configured, Wizard ✅** | | **komodo-mcp** (samik081) | Docker-Management **5 Hosts** via Komodo Core (ersetzt Portainer) | DS923 (`.10`), macvlan-IP **`.176`** | SSE `http://10.40.41.176:3000/sse` | `ghcr.io/samik081/mcp-komodo:latest` | `mcp/komodo/` ✓ (`.env.example` → `.env` nach Phase 1) | 🟡 **geplant — Migration: `mcp/komodo/MIGRATION.md`** | | ~~portainer-mcp~~ (offiziell) | Docker-Überblick via Portainer CE 2.40.0 | `.126:9443` | — | `portainer/portainer-mcp` | `mcp/portainer/` (Token .env ✓) | ⏳ **retired nach Komodo-Migration — Token aufheben bis Phase 4** | diff --git a/mcp/omada/.env.template b/mcp/omada/.env.template index 41d59bb..10007d9 100644 --- a/mcp/omada/.env.template +++ b/mcp/omada/.env.template @@ -1,13 +1,20 @@ # omada-mcp Secrets — .env (gitignored). Dieses File = Template, .env = echte Werte. # -# jmtvms/tplink-omada-mcp nutzt die Omada OPEN API (nicht User/Passwort!). -# Client-Credentials erzeugen: Controller-UI → Settings → Platform Integration → Open API → -# neuen App-Eintrag (Grant Type: Client Credentials) → liefert Client ID + Client Secret. -# omadac_id: aus https://10.40.41.175:8043/api/info → result.omadacId -# site_id: Controller-UI Site-Auswahl, oder API /{omadacId}/api/v2/sites → result.data[].id +# jmtvms/tplink-omada-mcp v0.15: StreamableHTTP-Transport + Omada OPEN API (Client Credentials). +# Client-Creds erzeugen: Controller-UI → Settings → Platform Integration → Open API → +# App anlegen (Grant Type: Client Credentials) → liefert Client ID + Client Secret. +# omadac_id: https://10.40.41.175:8043/api/info → result.omadacId +# site_id: Controller-UI Site, oder API /{omadacId}/api/v2/sites → result.data[].id -MCP_TRANSPORT=sse -PORT=3000 +# --- Transport: StreamableHTTP auf :3000/mcp --- +MCP_SERVER_USE_HTTP=true +MCP_HTTP_BIND_ADDR=0.0.0.0 +MCP_HTTP_PORT=3000 +MCP_HTTP_PATH=/mcp +MCP_HTTP_ENABLE_HEALTHCHECK=true +MCP_HTTP_HEALTHCHECK_PATH=/health + +# --- Omada Open API --- OMADA_BASE_URL=https://10.40.41.175:8043 OMADA_OMADAC_ID=adbef8fa3505fb16b09818eab71d824e OMADA_CLIENT_ID=REPLACE_OPENAPI_CLIENT_ID diff --git a/mcp/omada/docker-compose.yml b/mcp/omada/docker-compose.yml index 3054451..2cccbae 100644 --- a/mcp/omada/docker-compose.yml +++ b/mcp/omada/docker-compose.yml @@ -1,15 +1,19 @@ -# omada-mcp — TP-Link Omada Controller MCP Server +# omada-mcp — TP-Link Omada Controller MCP Server (jmtvms/tplink-omada-mcp v0.15) # Host: pve-LXC (10.40.41.126, Portainer endpointId=2) — Docker-LXC auf Proxmox -# Image: jmtvms/tplink-omada-mcp (stdio by default, SSE via MCP_TRANSPORT=sse) # IP: 10.40.41.176 (ipvlan default_external) — .173=pve-mcp, .175=omada-controller (beide auf DS923) # -# Hinweis: pve-LXC-Disk ist klein (1GB-Controller-Image scheiterte dort → Controller läuft auf DS923). -# omada-mcp (~node-alpine) ist klein genug für den pve-LXC. +# Transport: StreamableHTTP (NICHT SSE) → Endpoint http://10.40.41.176:3000/mcp, Health /health +# Auth: Omada OPEN API (Client Credentials) — KEIN username/password! +# Creds: Controller-UI → Settings → Platform Integration → Open API (Grant: Client Credentials). # -# Deploy (via Portainer API, endpointId=2): -# POST /api/stacks/create/standalone/string?endpointId=2 -# Env beim Deploy inline (env_file findet Portainer nicht) — Werte aus .env. -# Claude Code: ~/.claude/settings.json → "omada-mcp": {"url": "http://10.40.41.176:3000/sse"} +# Hinweis: pve-LXC-Disk ist klein (1GB-Controller-Image scheiterte dort → Controller läuft auf DS923). +# omada-mcp (node-alpine) ist klein genug für den pve-LXC. +# +# Deploy/Update (via Portainer API, endpointId=2): +# POST /api/stacks/create/standalone/string?endpointId=2 (erstmalig) +# PUT /api/stacks/200?endpointId=2 (update, Stack-Id=200) +# ⚠️ Portainer-String-Deploy findet env_file NICHT → Env beim Deploy INLINE senden (Werte aus .env). +# Claude Code: ~/.claude/settings.json → "omada-mcp": {"url": "http://10.40.41.176:3000/mcp"} services: omada-mcp: @@ -20,13 +24,10 @@ services: default_external: ipv4_address: 10.40.41.176 env_file: .env - # Env-Vars (Omada OPEN API, in .env setzen — siehe .env.template): - # MCP_TRANSPORT=sse · PORT=3000 - # OMADA_BASE_URL=https://10.40.41.175:8043 - # OMADA_OMADAC_ID= · OMADA_SITE_ID= - # OMADA_CLIENT_ID / OMADA_CLIENT_SECRET= - # OMADA_STRICT_SSL=false - # ACHTUNG: Portainer-String-Deploy findet env_file NICHT → Env beim Deploy inline senden. + # Env-Vars (siehe .env.template) — Transport + Omada Open API: + # MCP_SERVER_USE_HTTP=true · MCP_HTTP_BIND_ADDR=0.0.0.0 · MCP_HTTP_PORT=3000 · MCP_HTTP_PATH=/mcp + # MCP_HTTP_ENABLE_HEALTHCHECK=true · MCP_HTTP_HEALTHCHECK_PATH=/health + # OMADA_BASE_URL · OMADA_OMADAC_ID · OMADA_SITE_ID · OMADA_CLIENT_ID · OMADA_CLIENT_SECRET · OMADA_STRICT_SSL=false networks: default_external: