WordPress MCP Server

Un puente seguro entre asistentes de IA y WordPress, que permite la gestión del sitio y operaciones de contenido a través de lenguaje natural.

GitHub
1

Documentación

WordPress MCP Server

npm version License: MIT Node.js Version PRs Welcome

Un servidor de Model Context Protocol (MCP) que permite a asistentes de IA como Claude interactuar con sitios WordPress a través de una interfaz estandarizada.

Descripción

WordPress MCP Server proporciona un puente seguro entre asistentes de IA e instalaciones de WordPress, permitiendo la gestión de contenido, administración del sitio y operaciones de plugins/temas mediante interacciones en lenguaje natural. Construido sobre el estándar Model Context Protocol, ofrece un conjunto completo de herramientas para la automatización de WordPress.

Características

  • Gestión de contenido: Crear, leer, actualizar y eliminar entradas, páginas y tipos de contenido personalizados
  • Manejo de medios: Subir y gestionar archivos multimedia con optimización automática
  • Gestión de usuarios: Manejar operaciones de usuario y permisos
  • Control de plugins y temas: Instalar, activar, desactivar y gestionar plugins/temas
  • Configuración del sitio: Gestionar ajustes y configuraciones de WordPress
  • Tipos de contenido personalizados: Soporte completo para tipos de contenido personalizados y taxonomías
  • Integración SEO: Soporte integrado para plugins SEO populares
  • Seguridad: Autenticación OAuth2 y comunicaciones API seguras
  • Operaciones por lotes: Acciones masivas eficientes para contenido y medios
  • Actualizaciones en tiempo real: Monitoreo de estado y salud del sitio en vivo

Requisitos previos

  • Node.js 16.0 o superior
  • npm o yarn como gestor de paquetes
  • WordPress 5.0 o superior con la API REST habilitada
  • Credenciales de administrador de WordPress válidas o contraseñas de aplicación
  • Claude Code o cualquier cliente compatible con MCP

Instalación

Inicio rápido con npx (Recomendado)

npx wordpress-mcp-server init

Instalación local

# Clone the repository
git clone https://github.com/yourusername/wordpress-mcp-server.git
cd wordpress-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Configure your WordPress connection
npm run configure

Instalación global

npm install -g wordpress-mcp-server
wordpress-mcp configure

Configuración

Configuración inicial

  1. Crea un archivo de configuración:
npx wordpress-mcp-server configure
  1. O crea manualmente wordpress-config.json:
{
  "sites": [
    {
      "name": "my-wordpress-site",
      "url": "https://example.com",
      "username": "admin",
      "password": "your-application-password",
      "authMethod": "basic"
    }
  ],
  "defaultSite": "my-wordpress-site"
}

Métodos de autenticación

Contraseñas de aplicación (Recomendado)

  1. Ve a Administración de WordPress → Usuarios → Tu perfil
  2. Desplázate hasta "Contraseñas de aplicación"
  3. Ingresa un nombre y haz clic en "Agregar nueva contraseña de aplicación"
  4. Copia la contraseña generada a tu configuración

Autenticación básica

  • Requiere el plugin HTTP Basic Auth
  • Menos segura, úsala solo para desarrollo

OAuth2

Ejemplos de uso

Con Claude Code

  1. Agrega a la configuración de Claude Code:
{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["wordpress-mcp-server", "start"]
    }
  }
}
  1. Usa comandos en lenguaje natural:
"Create a new blog post about AI trends with featured image"
"Update the homepage content"
"Install and activate Yoast SEO plugin"
"Bulk upload images from folder"

Uso programático

const { WordPressMCP } = require('wordpress-mcp-server');

const mcp = new WordPressMCP({
  site: 'my-wordpress-site'
});

// Create a post
await mcp.tools.createPost({
  title: 'Hello World',
  content: 'This is my first post!',
  status: 'publish'
});

Herramientas MCP disponibles

Herramientas de contenido

  • wp_create_post - Crear entradas, páginas o tipos de contenido personalizados
  • wp_update_post - Actualizar contenido existente
  • wp_get_post - Obtener detalles de una entrada
  • wp_delete_post - Eliminar contenido
  • wp_list_posts - Listar y filtrar contenido

Herramientas de medios

  • wp_upload_media - Subir imágenes, videos, documentos
  • wp_get_media - Obtener información de medios
  • wp_delete_media - Eliminar archivos multimedia
  • wp_optimize_images - Optimización masiva de imágenes

Gestión del sitio

  • wp_get_site_info - Detalles y salud del sitio
  • wp_update_settings - Modificar ajustes del sitio
  • wp_clear_cache - Limpiar varias cachés
  • wp_backup_site - Crear copias de seguridad del sitio

Herramientas de plugins y temas

  • wp_install_plugin - Instalar desde el repositorio
  • wp_activate_plugin - Activar plugins instalados
  • wp_update_plugin - Actualizar a la última versión
  • wp_list_themes - Temas disponibles

Gestión de usuarios

  • wp_create_user - Agregar nuevos usuarios
  • wp_update_user - Modificar detalles de usuario
  • wp_list_users - Obtener listados de usuarios
  • wp_manage_roles - Gestión de roles y capacidades

Solución de problemas

Problemas comunes

Error de conexión

  • Verifica que la URL de WordPress sea correcta
  • Comprueba que la API REST esté habilitada: https://yoursite.com/wp-json/
  • Asegúrate de que las credenciales sean válidas

Errores de autenticación

  • Las contraseñas de aplicación requieren WordPress 5.6+
  • El nombre de usuario debe ser tu nombre de inicio de sesión, no el correo electrónico
  • Algunos hosts bloquean la autenticación de la API REST

Permiso denegado

  • El usuario necesita las capacidades apropiadas de WordPress
  • Verifica los permisos de instalación de plugins/temas
  • Comprueba los límites de subida de archivos

Modo de depuración

Habilita el registro detallado:

export WP_MCP_DEBUG=true
npx wordpress-mcp-server start

Obtener ayuda

Contribuciones

¡Agradecemos las contribuciones! Consulta nuestras Pautas de contribución para más detalles.

Seguridad

Para inquietudes de seguridad, revisa nuestra Política de seguridad y reporta los problemas de manera responsable.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.

Agradecimientos

  • Construido sobre el estándar Model Context Protocol
  • Documentación y comunidad de la API REST de WordPress
  • Claude y Anthropic por el desarrollo de MCP

Hecho con ❤️ para las comunidades de WordPress e IA