obot-admin-mcp

Un servidor MCP que permite a un cliente MCP (claude.ai, Claude Desktop, etc.) gestionar una pasarela MCP obot autohospedada a través de su API REST. Úselo para instalar, listar, inspeccionar y eliminar servidores MCP en obot desde dentro del cliente de chat.

Por qué

obot expone cada servidor MCP registrado como https://<obot-host>/mcp-connect/<id>. Para instalar un nuevo servidor MCP, normalmente se accede a la API REST de obot o a su interfaz de administración. Este paquete envuelve los puntos finales relevantes como herramientas MCP, por lo que una vez que registra obot-admin-mcp en el propio obot y conecta su connectURL en claude.ai, puede pedirle a Claude que "instale el MCP de n8n" o "liste todo lo que tiene obot" y simplemente funciona.

Herramientas

• list_mcp_servers — id, nombre, tiempo de ejecución, estado configurado, connectURL.

• get_mcp_server(id) — manifiesto completo, entorno, variables requeridas faltantes.

• add_npx_mcp(name, package, env?, sensitiveKeys?, shortDescription?, alias?) — instalar un MCP stdio publicado en npm.

• add_remote_mcp(name, url, shortDescription?, alias?) — registrar un MCP HTTP/SSE remoto.

• delete_mcp_server(id) — eliminar un MCP de obot.

• list_catalog_entries(search?) — explorar el catálogo de obot (por defecto 81 entradas).

Configuración

Dos variables de entorno:

Ejecutar localmente (Claude Desktop / dev)

Instalar directamente desde este repositorio (no se requiere publicación en npm — el dist/ compilado está confirmado):

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

Registrar dentro de obot (el meta bucle)

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

La respuesta incluye connectURL: péguelo en claude.ai → Configuración → Conectores → Añadir conector personalizado.

Seguridad

El token de arranque/administrador otorga control total de obot, que monta el socket de docker del host. Trate el token como una credencial de root. No registre obot-admin-mcp en un obot compartido/multi-inquilino sin una capa de autenticación adicional (por ejemplo, Cloudflare Access frente a obot-connect/<id>).

Licencia

MIT