obot-admin-mcp

Ein MCP-Server, der es einem MCP-Client (claude.ai, Claude Desktop usw.) ermöglicht, ein selbst gehostetes obot MCP-Gateway über dessen REST-API zu verwalten. Verwenden Sie ihn, um MCP-Server in obot direkt aus dem Chat-Client heraus zu installieren, aufzulisten, zu überprüfen und zu entfernen.

Warum

obot stellt jeden registrierten MCP-Server unter https://<obot-host>/mcp-connect/<id> bereit. Um einen neuen MCP-Server zu installieren, greifen Sie normalerweise auf die REST-API oder die Admin-Benutzeroberfläche von obot zu. Dieses Paket kapselt die relevanten Endpunkte als MCP-Tools. Sobald Sie obot-admin-mcp in obot selbst registriert und dessen connectURL in claude.ai eingebunden haben, können Sie Claude bitten, „den n8n-MCP zu installieren“ oder „alles aufzulisten, was obot hat“, und es funktioniert einfach.

Tools

• list_mcp_servers — id, name, runtime, configured-state, connectURL.

• get_mcp_server(id) — vollständiges Manifest, env, fehlende erforderliche Variablen.

• add_npx_mcp(name, package, env?, sensitiveKeys?, shortDescription?, alias?) — installiert einen via npm veröffentlichten stdio-MCP.

• add_remote_mcp(name, url, shortDescription?, alias?) — registriert einen Remote-HTTP/SSE-MCP.

• delete_mcp_server(id) — entfernt einen MCP aus obot.

• list_catalog_entries(search?) — durchsucht den Katalog von obot (standardmäßig 81 Einträge).

Konfiguration

Zwei Umgebungsvariablen:

Lokal ausführen (Claude Desktop / Entwicklung)

Direkt aus diesem Repository installieren (keine npm-Veröffentlichung erforderlich — das erstellte dist/ ist eingecheckt):

{
  "mcpServers": {
    "obot-admin": {
      "command": "npx",
      "args": ["-y", "github:kiarashedraki/obot-admin-mcp"],
      "env": {
        "OBOT_URL": "https://obot.edraki.me",
        "OBOT_TOKEN": "<your-token>"
      }
    }
  }
}

Innerhalb von obot registrieren (die Meta-Schleife)

curl -X POST https://obot.edraki.me/api/mcp-servers \
  -H "Authorization: Bearer $OBOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": {
      "name": "obot-admin",
      "shortDescription": "Manage obot itself",
      "runtime": "npx",
      "npxConfig": { "package": "obot-admin-mcp" },
      "env": [
        { "key": "OBOT_URL",   "value": "https://obot.edraki.me", "required": true,  "sensitive": false },
        { "key": "OBOT_TOKEN", "value": "<token>",                "required": true,  "sensitive": true  }
      ]
    },
    "alias": "obot-admin"
  }'

Die Antwort enthält die connectURL — fügen Sie diese in claude.ai → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen ein.

Sicherheit

Das Bootstrap-/Admin-Token bietet die volle Kontrolle über obot, welches den Docker-Socket des Hosts einbindet. Behandeln Sie das Token wie ein Root-Passwort. Registrieren Sie obot-admin-mcp nicht auf einem gemeinsam genutzten/Multi-Tenant-obot ohne eine zusätzliche Authentifizierungsschicht (z. B. Cloudflare Access vor obot-connect/<id>).

Lizenz

MIT