Lean MCP
Un servidor MCP pequeño para WordPress: cualquier plugin expone sus Abilities como herramientas MCP.
- PHP8.4+
- WordPress6.9+
Qué hace
Lean MCP es un servidor MCP para WordPress. Cualquier plugin declara un Server que expone sus Abilities (la Abilities API que WordPress trae en el core desde la 6.9) como herramientas, prompts o recursos MCP. Habla la versión 2026-07-28 del protocolo, sin estado, y también responde a clientes de 2025-11-25 y 2025-06-18. Se autentica con contraseñas de aplicación de WordPress sobre HTTP Basic o corre por stdio como un usuario de WP-CLI. No tiene dependencias en tiempo de ejecución y no carga nada hasta que una petición llega a una ruta MCP. Disponible gratis en GitHub bajo licencia GPL-2.0-or-later.
El problema
La Abilities API le da a WordPress una forma estándar de describir lo que un plugin sabe hacer, pero un agente de IA necesita hablar MCP para usarlo. Lean MCP hace ese puente sin dependencias y sin cargar nada en las peticiones normales del sitio.
Características
Servers por plugin
Cada plugin declara su Server con lean_mcp_register_server y elige qué Abilities expone: por nombre, por categoría, por metadatos o todas las públicas para MCP. Queda en /wp-json/lean-mcp/<id>.
Herramientas, prompts y recursos
Una Ability es herramienta por defecto, y con meta.mcp.type pasa a ser un prompt que el cliente ofrece como comando o un recurso con su URI. Lee las mismas claves que mcp-adapter, así que las Abilities escritas para él funcionan igual.
Permisos de WordPress
Una capability decide quién puede conectarse al Server, y cada Ability conserva su propio permission_callback. Se autentica con contraseñas de aplicación o como usuario de WP-CLI por stdio.
Modo gateway
En lugar de listar una herramienta por Ability, el Server ofrece tres: descubrir, describir y llamar. El cliente carga tres definiciones cortas en vez de todos los esquemas de entrada.
Confirmación de acciones destructivas
Con confirm_destructive, una llamada a una Ability marcada como destructiva le pide confirmación al usuario antes de ejecutarse, mediante un formulario de elicitation.
Hooks para auditar y filtrar
Filtros para ocultar o reordenar Abilities, cambiar la entrada, detener una llamada o redactar el resultado, y una acción después de cada llamada con lo que un log de auditoría necesita.
Beneficios
- Gratuito y de código abierto
- Sin dependencias en tiempo de ejecución
- No carga nada fuera de las rutas MCP
- Compatible con tres versiones del protocolo MCP
- Reutiliza las Abilities escritas para mcp-adapter
Incluye
- Plugin listo para instalar (lean-mcp.zip en cada release)
- Código fuente público en GitHub
- Documentación de hooks y decisiones de diseño en el repositorio
- Comando wp lean-mcp list para ver cada Server con su URL
- Soporte vía GitHub Issues
- Licencia GPL-2.0-or-later
APIs soportadas
- Model Context Protocol
- WordPress Abilities API
- WordPress REST API
- WP-CLI
Preguntas frecuentes
¿Qué versiones necesito?
PHP 8.4 o superior y WordPress 6.9 o superior, que es la versión que trae la Abilities API en el core.
¿Cómo conecto un cliente MCP?
Crea una contraseña de aplicación para un usuario que tenga la capability del Server y apunta el cliente a la URL del Server con un header Authorization Basic. Para un cliente local también puedes arrancarlo por stdio con wp lean-mcp serve, sin contraseña de aplicación.
¿Sirve con Abilities escritas para mcp-adapter?
Sí. Lean MCP lee las mismas claves de las Abilities que mcp-adapter (etiqueta, descripción, esquemas, anotaciones y meta.mcp), así que funcionan sin cambios.
¿Afecta el rendimiento del sitio?
No carga nada hasta que una petición llega a una ruta MCP, y no tiene dependencias en tiempo de ejecución.
¿Listo para usarlo?
Descarga el plugin desde GitHub. Si tienes dudas, contáctame y te ayudo a configurarlo.