Drupal MCP Connector | Wilkes & Liberty

Drupal MCP Connector está dirigido a operadores de contenido, equipos de confiabilidad de sitios y desarrolladores que quieren que un cliente de IA trabaje con Drupal mediante herramientas explícitas, en lugar de automatización del navegador o acceso irrestricto al shell. Wilkes & Liberty mantiene el servicio Node.js con licencia MIT. Puede conectar un cliente MCP a uno o varios sitios Drupal, normalizar JSON:API y GraphQL en un único modelo de entidades y exponer operaciones gobernadas de lectura, auditoría y escritura.

Por qué existe

Los asistentes de IA pueden razonar sobre el contenido, pero la superficie administrativa de Drupal fue diseñada para personas que hacen clic en formularios. Darle a un agente una sesión de navegador es frágil; darle acceso a la base de datos o por SSH es demasiado amplio; escribir una integración personalizada para cada tipo de contenido no escala. El conector convierte las API compatibles de Drupal en una superficie documentada del Model Context Protocol con parámetros tipados, verificaciones de capacidad, ejecuciones de prueba y salida acotada.

Quién debería usarlo y cuándo

Equipos editoriales y de operaciones de contenido que auditan contenido obsoleto, metadatos, taxonomía, accesibilidad, enlaces y estado de flujo de trabajo en un sitio grande.
Desarrolladores Drupal que crean contenido borrador estructurado, resuelven referencias de entidades, gestionan Paragraphs o inspeccionan la configuración del sitio desde un cliente de programación compatible con MCP.
Operadores de plataforma que trabajan en varios entornos Drupal con distintas URL, credenciales y capacidades permitidas.
Equipos de seguridad que quieren un perfil de auditor de solo lectura o un plano de escritura restringido en lugar de una credencial de administrador de propósito general.

Úselo cuando un cliente MCP necesite operaciones Drupal repetibles con un envolvente de seguridad claro. No es necesario para un chatbot simple de contenido público que pueda consumir una fuente de solo lectura creada para ese fin.

Dónde se ubica

El conector se ejecuta como un proceso Node.js independiente, normalmente lanzado sobre MCP stdio por Claude, Codex, Gemini u otro cliente compatible con MCP. También puede exponer un transporte HTTPS autenticado para operación compartida o remota. Del lado de Drupal, usa JSON:API del núcleo para el plano de escritura y JSON:API o GraphQL Compose para las lecturas. Un puente Drush por SSH opcional alcanza tareas administrativas que las API HTTP no exponen.

Esta separación importa: el conector traduce la intención del agente en llamadas a la API de Drupal, pero Drupal sigue siendo el sistema de registro. Combinarlo con MCP Sentinel traslada la decisión final de política al interior de Drupal, donde la configuración del conector no puede eludirla.

Qué ofrece

La versión 2.2.1 expone 119 herramientas en 26 módulos, además de recursos y prompts MCP. La superficie incluye:

Operaciones sobre nodos, taxonomía, medios, usuarios, Paragraphs, menús, bloques, redirecciones, traducciones y entidades genéricas.
Flujos de trabajo de moderación, revisiones, programación, resolución de relaciones y operaciones masivas.
Informes de solo lectura sobre completitud del contenido, SEO, accesibilidad, enlaces rotos, salud de redirecciones, desvío de configuración, permisos, formatos de texto, cachés, exposición de PII y cuellos de botella en el flujo de trabajo.
Una auditoría compuesta de salud del sitio que consolida los hallazgos de contenido, enlaces y configuración en un único informe con puntuación.
Backends JSON:API y GraphQL conscientes de las capacidades. GraphQL Compose se trata como de solo lectura; las escrituras no compatibles fallan con claridad en lugar de pasar sin control.
Soporte de ejecución de prueba en herramientas destructivas o de mutación, para que un operador pueda inspeccionar el cambio propuesto antes de confirmarlo.

Una ruta de solicitud típica

El cliente MCP inicia el conector y selecciona un perfil de sitio Drupal con nombre.
El conector se autentica con el token OAuth configurado, credenciales de cliente u otro método específico del sitio.
El cliente llama a una herramienta acotada como “listar nodos no publicados”, “auditar metadatos faltantes” o “crear un artículo en borrador”.
El conector valida la solicitud contra su preajuste de seguridad y las reglas de entidad/campo, selecciona el backend disponible y normaliza la respuesta.
Para las escrituras, Drupal evalúa sus propias reglas de acceso a entidades y de moderación; MCP Sentinel puede añadir controles de alcance OAuth, perfil, redacción, publicación y auditoría dentro del CMS.
El conector devuelve resultados estructurados y fallas por elemento, en lugar de fingir que una operación masiva parcial tuvo éxito.

Modelo de seguridad

El preajuste predeterminado es production-strict: solo lectura, con los tipos de entidad sensibles denegados y redacción amplia de PII. Otros preajustes explícitos admiten auditores, editores de contenido, editores de configuración y un plano de escritura con la publicación deshabilitada de forma predeterminada. Las listas de entidades permitidas, las restricciones de raíz de carga, los límites de tasa, las puertas de GraphQL, la autenticación del transporte y los topes de salida restringen aún más el conector.

Estos son controles del lado del conector, no un sustituto de la autorización de Drupal. MCP Sentinel proporciona el límite complementario del lado del servidor: perfiles de política seleccionados por rol, alcances OAuth, bloqueos de contenido, redacción de campos, DLP, cuotas, detección de anomalías, webhooks confiables y un registro de auditoría a prueba de manipulación.

Instalar y conectar

Requiere Node.js 20+ y Drupal 10 u 11. JSON:API se incluye con el núcleo de Drupal; las lecturas GraphQL requieren GraphQL Compose; la autenticación por token suele usar Simple OAuth.

npm install -g drupal-mcp-connector
# Or run without a global install:
npx -y drupal-mcp-connector

Un registro stdio mínimo se ve así:

{
  "mcpServers": {
    "drupal": {
      "command": "drupal-mcp-connector",
      "env": {
        "DRUPAL_BASE_URL": "https://cms.example.gov",
        "DRUPAL_API_TOKEN": "managed-outside-source-control"
      }
    }
  }
}

Para la configuración multisitio, el transporte HTTPS, las credenciales de cliente OAuth, GraphQL y el puente Drush, siga las guías de inicio y de despliegue del repositorio.

Límites honestos

El conector no hace que un agente de IA sea correcto, no autoriza una solicitud que Drupal deniega ni convierte GraphQL Compose en una API de mutaciones. Los informes son análisis de mejor esfuerzo sobre los datos que la credencial puede ver; el filtrado GraphQL acotado o del lado del cliente puede ser aproximado y se etiqueta como tal. El puente Drush es un límite de confianza administrativo independiente y debe permanecer deshabilitado salvo que un operador lo necesite. El SQL sin procesar está desactivado salvo que tanto el conector como MCP Sentinel opten por la ruta gobernada.

Los operadores siguen siendo responsables del almacenamiento de credenciales, los roles de mínimo privilegio, la revisión de la salida de las ejecuciones de prueba, la separación de entornos y la decisión de qué acciones requieren aprobación humana.

Proyecto, paquete, código fuente y soporte

Mantenido por Jeremy Michael Cerda y Wilkes & Liberty bajo la licencia MIT. La versión de código fuente verificada para esta página es la 2.2.1.