MCP WordPress Server

🚀 MCP WordPress Server

🎯 ¿Por qué este servidor MCP?

Transforma la gestión de WordPress de paneles de administración complejos a conversaciones simples:

❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save
✅ After:  "Create a new blog post about AI trends with SEO optimization"

Ventajas clave:

• 🏆 Más completo: 71 herramientas frente a 20-30 en alternativas
• ⚡ Configuración más rápida: instalación de Claude Desktop en 2 clics mediante DXT
• 🔒 Probado en CI: más de 2750 pruebas en Node 20/22/24, escaneo de seguridad con CodeQL + Trivy
• 🎯 TypeScript nativo: 100% seguridad de tipos, experiencia de desarrollador de primer nivel
• 🌐 Multi-sitio: gestiona hasta 50 sitios de WordPress desde un solo lugar

🚀 Inicio rápido

Ponte en marcha en menos de 5 minutos:

Requisitos previos

• WordPress: versión 5.6+ con API REST habilitada
• Claude Desktop: última versión instalada
• Contraseña de aplicación: generada desde el panel de administración de WordPress

Configuración en 3 pasos

1️⃣ Genera la contraseña de aplicación de WordPress

WordPress Admin → Users → Profile → Application Passwords → Add New

2️⃣ Instala el servidor MCP (elige uno)

Opción A: Extensión DXT (la más fácil)

# Download and install in Claude Desktop
curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
# Then: Claude Desktop → Extensions → Install → Select DXT file

Opción B: Instalación global con NPM

npm install -g mcp-wordpress

3️⃣ Prueba tu conexión

In Claude: "Test my WordPress connection"
Response: "✅ Authentication successful! Connected to: Your Site Name"

📺 Ver video de configuración de 2 minutos | 📖 Guía de configuración detallada

⚡ Opciones de instalación

🏆 Recomendado: Extensión de Claude Desktop (DXT)

La instalación más fácil: ¡solo 2 clics!

1. Descarga: mcp-wordpress.dxt (3.4MB)
2. Instala: Claude Desktop → Extensiones → Instalar → Selecciona el archivo DXT
3. Configura: introduce la URL de tu sitio de WordPress y las credenciales

✅ No requiere línea de comandos ✅ Actualizaciones fáciles ✅ Seguridad integrada

📖 Guía completa de configuración de DXT →

🚀 Alternativa: NPX (usuarios avanzados)

# Run directly - always latest version
npx -y mcp-wordpress

# Interactive setup wizard
npm run setup

🔧 Otras opciones

• 💻 Configuración con NPM - Desarrollo local
• 🐳 Configuración con Docker - Despliegue en producción
• 🔧 Compilación manual - Compilaciones personalizadas

📋 Configuración

Sitio único (.env)

WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

Configuración de Claude Desktop

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

📖 Guía de configuración completa — multi-sitio, JWT, Docker, entornos de producción

🔐 Autenticación

Se recomiendan las contraseñas de aplicación de WordPress:

1. Administración de WordPress → Usuarios → Perfil → Contraseñas de aplicación → Añadir nueva
2. Copia la contraseña generada en tu configuración

Métodos alternativos: JWT, autenticación básica, clave API — consulta Configuración de autenticación

🌟 ¿Qué hace que esto sea especial?

Característica	Este servidor	Competencia
Herramientas disponibles	71 herramientas	20-30 herramientas
Claude Desktop DXT	✅ Instalación en 2 clics	❌ Configuración manual
Soporte multi-sitio	✅ Hasta 50 sitios	❌ Sitio único
TypeScript	✅ 100% TypeScript, modo estricto	⚠️ Parcial/Ninguno
Monitoreo de rendimiento	✅ Analíticas en tiempo real	❌ Solo básico
Cobertura de pruebas	✅ Más de 2750 pruebas, ~76% de cobertura de líneas	⚠️ Limitada
Escaneo de seguridad	✅ CodeQL + Trivy en CI	⚠️ Desconocido

📋 Herramientas disponibles (71 herramientas)

Gestión de contenido

• 📝 Entradas (6 herramientas) - Crear, editar, eliminar, listar entradas y revisiones
• 📄 Páginas (6 herramientas) - Gestionar páginas estáticas y revisiones
• 🖼️ Medios (5 herramientas) - Subir, gestionar biblioteca de medios y archivos
• 🔍 SEO (11 herramientas) - Análisis de contenido, metadatos, marcado de esquema, seguimiento de SERP, investigación de palabras clave

Usuarios y comunidad

• 👥 Usuarios (6 herramientas) - Gestión de usuarios y perfiles
• 💬 Comentarios (7 herramientas) - Moderación y gestión de comentarios
• 🏷️ Taxonomías (10 herramientas) - Gestión de categorías y etiquetas

Gestión del sitio

• ⚙️ Ajustes del sitio (6 herramientas) - Configuración y estadísticas del sitio
• 🔐 Autenticación (3 herramientas) - Pruebas y gestión de autenticación
• ⚡ Gestión de caché (4 herramientas) - Control de caché de rendimiento
• 📊 Monitoreo de rendimiento (6 herramientas) - Métricas en tiempo real y optimización
• 🛠️ Sistema (1 herramienta) - Comprobación de versión

📖 Documentación completa de herramientas | Referencia de API en vivo

🤖 Ejemplos

💬 "Create a new blog post about AI trends with SEO optimization"
💬 "Check my WordPress site performance and provide optimization recommendations"
💬 "Find all draft posts older than 30 days and provide a summary"
💬 "Batch update all client sites with the new privacy policy footer"
💬 "List all posts from my client-blog site"

📖 Más ejemplos | Flujos de trabajo reales

🧪 Pruebas y seguridad

npm test              # Full test suite (2750/2750 passing, 94 files)
npm run test:security # Security tests (371/371 passing)
npm run health        # System health check

📖 Documentación de seguridad — cobertura OWASP, pruebas de penetración, cumplimiento

🛠️ Solución de problemas

npm run health         # System check
DEBUG=true npm run dev # Debug logging
npm run fix:rest-auth  # Fix WordPress 401 errors

Error	Solución
401 Unauthorized	Regenera la contraseña de aplicación
403 Forbidden	Comprueba el rol de usuario (se requiere Editor o superior)
404 Not Found	Verifica WORDPRESS_SITE_URL
Connection Timeout	Comprueba el acceso a la API REST de WordPress

📖 Guía completa de solución de problemas

📚 Documentación

Primeros pasos

• Guía de inicio rápido - Ponte en marcha en 5 minutos
• Guía de instalación - Instrucciones detalladas de configuración
• Guía de configuración - Todas las opciones de configuración
• Configuración de autenticación - Métodos de autenticación de WordPress

Guías de usuario

• Uso básico - Tareas y flujos de trabajo comunes
• Flujos de trabajo avanzados - Automatización compleja
• Gestión multi-sitio - Gestión de múltiples sitios
• Solución de problemas - Problemas comunes y soluciones

Guías de integración

• Claude Desktop - Integración completa con Claude
• VS Code - Configuración de la extensión de VS Code
• Cline - Integración con el asistente de IA Cline
• Guía para desarrolladores - Crea tu propio cliente MCP

Documentación para desarrolladores

• Referencia de API - Documentación completa de herramientas
• Arquitectura - Diseño y decisiones del sistema
• Contribuciones - Directrices de desarrollo
• Sistema de compilación - Compilación y publicación

Despliegue y operaciones

• Despliegue con Docker - Despliegue en contenedores
• Solución de problemas de publicación - Corrige problemas de publicación
• Mejores prácticas de seguridad - Seguridad en producción
• Caché - Guía de rendimiento y caché

🔧 Requisitos

• WordPress 5.0+ con API REST habilitada
• Se recomienda HTTPS para producción
• Contraseñas de aplicación habilitadas (WordPress 5.6+)

Rol	Acceso
Administrador	Acceso completo a todas las funciones
Editor	Entradas, páginas, comentarios, medios
Autor	Sus propias entradas y medios
Colaborador	Sus propias entradas (solo borradores)
Suscriptor	Solo lectura

🚀 Próximos pasos

¿Listo para transformar tu gestión de WordPress?

1. 🏆 Descargar la extensión DXT - La configuración más fácil (2 minutos)
2. ⚡ Probar el método NPX - Configuración para usuarios avanzados (5 minutos)
3. 📚 Explorar todas las herramientas - Descubre lo que es posible
4. 💬 Unirse a las discusiones - Obtén ayuda y comparte ideas

---

🔗 Proyectos similares

• Automattic WordPress MCP - Servidor MCP oficial de WordPress por Automattic

---

📋 Registro de cambios

v3.3.21 (julio de 2026)

• 🔒 Endurecimiento de seguridad - Lista de denegación SSRF, aplicación de HTTPS, redacción de registros, actualizaciones de versiones mínimas de dependencias
• 🐳 Fiabilidad de lanzamiento de Docker - Tiempos de espera limitados para trabajos de publicación y lógica corregida de reintento en bloqueos
• 📚 Documentación DOX - Árbol de contratos AGENTS.md jerárquico para guía de trabajo por directorio

Consulta CHANGELOG.md para ver el historial completo, versión por versión.

v3.3.14 (junio de 2026)

• 🔒 Actualizaciones de seguridad - Parchea vulnerabilidades moderadas de Hono, actualiza avisos permitidos incluidos en npm
• 🧪 CI - Mejoras en pruebas de humo y validación de Node 24

Serie v3.x (2025–2026)

• 🏗️ Arquitectura modular - Módulos de operación específicos de dominio y patrón de composición
• 🔄 Tolerancia a fallos - Patrón de interruptor de circuito con recuperación automática
• 📊 Más de 2200 pruebas - Suite de pruebas integral en seguridad, caché, servidor, cliente, configuración, utilidades, herramientas y rendimiento
• ⚡ Capa de caché - CachedWordPressClient con TTL configurable; solicitudes repetidas 50–70% más rápidas
• 🌐 Multi-sitio - Hasta 50 sitios de WordPress desde un solo archivo de configuración
• 🔐 4 métodos de autenticación - Contraseñas de aplicación (recomendado), JWT, básica, clave API
• 🐳 Docker y DXT - Extensión de Claude Desktop con un clic e imagen de Docker Hub

Para ver el historial completo, consulta CHANGELOG.md.

---

🙏 Agradecimientos

Un agradecimiento especial a Stephan Ferraro por el proyecto original que inspiró esta implementación.

---