genieacs-mcp

✨ Was Sie erhalten

Alles wird über einen einzigen JSON-RPC-Endpunkt (/mcp) bereitgestellt.
LLMs / Agenten können: initialize → readResource → listTools → callTool … und so weiter.

🚀 Schnellstart (Docker Compose)

Folgen Sie den Anweisungen unter https://github.com/GeiserX/genieacs-container, es ist in der dortigen Docker-Compose-Datei enthalten.

📦 Installation via npm (stdio-Transport)

npx genieacs-mcp

Oder global installieren:

npm install -g genieacs-mcp
genieacs-mcp

Dies lädt das vorkompilierte Go-Binary für Ihre Plattform herunter und führt es mit stdio-Transport aus, kompatibel mit jedem MCP-Client.

🛠 Lokaler Build

git clone https://github.com/GeiserX/genieacs-mcp
cd genieacs-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

🔧 Konfiguration

Fügen Sie diese in eine .env-Datei (aus .env.example) ein oder setzen Sie sie in der Umgebung.

Testen

Getestet mit Inspector und es funktioniert derzeit vollständig. Bevor Sie einen PR erstellen, stellen Sie sicher, dass sich dieser MCP-Server über dieses Medium korrekt verhält.

Es fehlt an Tests mit tatsächlichen MCP-Clients (Client-LLMs), daher reichen Sie bitte Ihre PRs ein, um die Beschreibungen zu verbessern, falls es die von diesem MCP-Server angebotenen Dienste nicht angemessen widerspiegelt.

Beispielkonfiguration für Client-LLMs:

{
  "schema_version": "v1",
  "name_for_human": "GenieACS-MCP",
  "name_for_model": "genieacs_mcp",
  "description_for_human": "Read data from GenieACS and run actions on CPEs (reboot, firmware update, parameter refresh).",
  "description_for_model": "Interact with an Auto-Configuration-Server (ACS) that manages routers. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with genieacs://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "logo_url": "https://raw.githubusercontent.com/GeiserX/genieacs-container/main/extra/logo.png",
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/genieacs-mcp/blob/main/LICENSE"
}

Credits

GenieACS – das beste Open-Source-ACS

MCP-GO – moderne MCP-Implementierung

GoReleaser – schmerzfreie Multi-Arch-Releases

Betreuer

@GeiserX.

Mitwirken

Fühlen Sie sich frei, mitzumachen! Öffnen Sie ein Issue oder reichen Sie PRs ein.

GenieACS-MCP folgt dem Contributor Covenant Verhaltenskodex.

GenieACS-Ökosystem

Dieses Projekt ist Teil einer breiteren Palette von Tools für die Arbeit mit GenieACS:

Andere MCP-Server von GeiserX

• cashpilot-mcp — Überwachung von passivem Einkommen

• duplicacy-mcp — Überwachung des Backup-Status

• lynxprompt-mcp — KI-Konfigurations-Blueprints

• pumperly-mcp — Kraftstoff- und EV-Ladepreise

• telegram-archive-mcp — Telegram-Nachrichtenarchiv