Skip to main content
Glama
WordPress MCP Server

WordPress MCP Server

by ernestoh0183

WordPress MCP Server

FastMCP Python WordPress License: MIT Author Website

Servidor de Model Context Protocol (MCP) basado en Python y FastMCP que proporciona a agentes de Inteligencia Artificial (Claude Desktop, Cursor, Antigravity, VS Code / Cline, Windsurf, etc.) control integral sobre sitios WordPress.

Desarrollado y mantenido por Rodrigo Ernesto Hernandez (4Ruy.com).

Permite redactar y publicar artículos, gestionar taxonomías multilingües con Polylang, subir imágenes de portada (locales, URLs o Base64), administrar plugins con comprobación de versiones en WordPress.org, moderar y responder comentarios, y purgar cachés de forma atómica.


📋 Tabla de Contenidos


Related MCP server: WordPress MCP Server

✨ Características Principales

  1. Gestión Editorial Completa: Lectura contextual del blog en texto plano para evitar duplicidad de temas, creación de borradores enriquecidos en HTML, actualización de posts existentes y control del ciclo de vida (borrador, publicar, papelera o eliminación permanente).

  2. Soporte Multilingüe (Polylang Free): Vinculación bidireccional nativa entre entradas en distintos idiomas (pll_save_post_translations) y de términos taxonómicos (pll_save_term_translations) superando las limitaciones de la REST API estándar de Polylang Free.

  3. Taxonomías Técnicas: CRUD de categorías y etiquetas con asignación de idioma, slugs limpios y descripciones optimizadas para SEO.

  4. Biblioteca Multimedia Inteligente: Subida de portadas e imágenes destacadas aceptando rutas locales del sistema operativo, URLs remotas o datos codificados en Base64, con asignación automática de texto alternativo (alt_text) y vinculación directa al post.

  5. Administración y Auditoría de Plugins: Listado de plugins activos e inactivos, consulta en tiempo real a la API pública de WordPress.org para verificar si existen actualizaciones disponibles, activación, desactivación y actualización de plugins.

  6. Moderación y Respuestas de Comentarios: Consulta de comentarios por estado (aprobado, pendiente, spam), cambio de estado y publicación de respuestas oficiales anidadas en el hilo.

  7. Purgado Multinivel de Caché: Endpoint optimizado para invalidar simultáneamente WP Super Cache, Docket Cache y la caché de código de bytes OPcache de PHP.


🏗️ Arquitectura y Estructura

wordpress-mcp-server/
├── wp_mcp_server.py          # Servidor FastMCP en Python (17 herramientas operativas)
├── requirements.txt          # Dependencias esenciales de Python
├── pyproject.toml            # Empaquetado y metadatos estándar de Python
├── .env.example              # Plantilla para variables de entorno de conexión
├── .gitignore                # Reglas estrictas de exclusión (ignora .env, cachés, etc.)
├── LICENSE                   # Licencia de código abierto MIT
├── README.md                 # Documentación técnica completa
└── wordpress-plugin/
    ├── README.md             # Guía de instalación del plugin puente
    └── polylang-mcp-bridge.php # Plugin WordPress para Polylang Free y purga de caché

🧰 Tecnologías Utilizadas

  • FastMCP / Model Context Protocol: Protocolo estándar abierto que permite a los LLMs interactuar de forma segura con herramientas locales y APIs.

  • Python 3.10+: Motor del servidor, con tipado estricto mediante anotaciones de tipo (typing).

  • Requests & HTTPBasicAuth: Comunicación robusta con la REST API de WordPress usando Application Passwords.

  • WordPress REST API (v2): Interfaz REST estándar de WordPress para posts, taxonomías, medios, plugins y ajustes.

  • Polylang Bridge (PHP): Micro-plugin complementario para solventar la ausencia de endpoints nativos de vinculación en la versión gratuita de Polylang.


🛠️ Catálogo de Herramientas MCP (17 Tools)

Módulo

Herramienta

Parámetros Principales

Descripción

Contenido

leer_contexto_blog

limite (int, default 5), idioma (opcional: 'es', 'en')

Obtiene los artículos recientes en texto plano para contextualizar estilo y evitar temas repetidos.

Contenido

publicar_borrador_wp

titulo, contenido_html, slug, resumen, categorias, etiquetas, imagen_portada_id, idioma, post_traduccion_id

Crea o actualiza una entrada en estado borrador con metadatos completos y asignación de idioma.

Contenido

actualizar_post

post_id, titulo, contenido_html, slug, resumen, estado, categorias, etiquetas, imagen_portada_id

Actualiza selectivamente cualquier campo de una entrada existente.

Contenido

gestionar_post

post_id, accion (publicar, borrador, papelera, eliminar)

Gestiona el ciclo de vida y visibilidad de un post.

Polylang

vincular_traducciones_polylang

post_id_es, post_id_en

Enlaza dos publicaciones como traducciones recíprocas Español/Inglés en Polylang Free.

Taxonomías

gestionar_categoria

accion (crear, actualizar, eliminar, listar), nombre, slug, descripcion, categoria_id, idioma

Operaciones CRUD completas para categorías con soporte multilingüe.

Taxonomías

gestionar_etiqueta

accion (crear, actualizar, eliminar, listar), nombre, slug, descripcion, etiqueta_id, idioma

Operaciones CRUD completas para etiquetas (tags).

Taxonomías

vincular_terminos_polylang

termino_id_es, termino_id_en, taxonomia (category o post_tag)

Vincula dos términos como traducciones directas en Polylang Free.

Medios

subir_imagen_portada

origen_imagen (ruta de archivo local, URL HTTP o datos Base64), nombre_archivo, texto_alt, post_id

Sube una imagen a la biblioteca de medios y opcionalmente la asigna como destacada.

Caché

purgar_cache_sitio

(Ninguno)

Invalida de forma atómica WP Super Cache, Docket Cache y OPcache.

Plugins

revisar_plugins

verificar_actualizaciones (bool, default True)

Lista plugins instalados (activos/inactivos) y consulta actualizaciones en WordPress.org.

Plugins

administrar_plugin

plugin_slug, accion (activar, desactivar, actualizar, eliminar)

Modifica el estado o actualiza cualquier plugin instalado.

Comentarios

revisar_comentarios

estado (all, approved, hold, spam, trash), limite, post_id

Lista comentarios con filtros por estado o por post.

Comentarios

moderar_comentario

comentario_id, accion (aprobar, mantener, spam, papelera, eliminar)

Aplica acciones de moderación sobre comentarios de usuarios.

Comentarios

responder_comentario

comentario_id, post_id, contenido

Publica una respuesta oficial anidada en el hilo de discusión.

Ajustes

obtener_configuraciones

(Ninguno)

Consulta metadatos globales del sitio (título, descripción, zona horaria, URL, etc.).

Ajustes

actualizar_configuracion

titulo, descripcion, zona_horaria, formato_fecha, formato_hora, site_logo_id

Actualiza configuraciones generales de WordPress.


🔑 Requisitos Previos en WordPress

1. Generar una Contraseña de Aplicación (Application Password)

WordPress incluye soporte nativo para Application Passwords desde la versión 5.6:

  1. Inicia sesión en el panel de control de WordPress con un usuario Administrador o Editor.

  2. Dirígete a Usuarios > Tu perfil.

  3. Desplázate hacia abajo hasta la sección Contraseñas de aplicación.

  4. Escribe un nombre descriptivo (por ejemplo: MCP Server) y pulsa en Añadir nueva contraseña de aplicación.

  5. Copia la contraseña de 24 caracteres generada (ej: xxxx xxxx xxxx xxxx xxxx xxxx).

NOTE

La contraseña de aplicación no expone tu contraseña personal y puede ser revocada en cualquier momento desde el mismo panel.

2. Instalar el Plugin Puente para Polylang y Caché (Opcional pero recomendado)

Si utilizas Polylang o sistemas de caché en servidor:

  1. Copia el archivo wordpress-plugin/polylang-mcp-bridge.php en la carpeta wp-content/plugins/polylang-mcp-bridge/ de tu instalación de WordPress.

  2. Activa el plugin WordPress MCP REST Bridge (Polylang & Cache) desde el menú Plugins de WordPress.


🚀 Instalación y Puesta en Marcha

1. Clonar el Repositorio

git clone https://github.com/ernestoh0183/wordpress-mcp-server.git
cd wordpress-mcp-server

2. Configurar el Entorno Virtual de Python

# Crear entorno virtual
python -m venv .venv

# Activar en Windows (PowerShell):
.\.venv\Scripts\Activate.ps1

# Activar en Linux/macOS:
source .venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

3. Configurar Credenciales (.env)

Copia la plantilla .env.example:

cp .env.example .env

Edita .env con los datos de tu sitio:

WP_URL=https://your-wordpress-site.com
WP_USER=your_username
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

🔌 Configuración en Clientes MCP

Claude Desktop

Edita tu archivo de configuración de Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py"],
      "env": {
        "WP_URL": "https://your-wordpress-site.com",
        "WP_USER": "your_username",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Cursor

En Cursor, abre Settings > Features > MCP Servers y añade un nuevo servidor:

  • Name: wordpress

  • Type: command

  • Command: python C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py

Antigravity / Gemini CLI

Añade a tu configuración en mcp_config.json:

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py"],
      "env": {
        "WP_URL": "https://your-wordpress-site.com",
        "WP_USER": "your_username",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

🔒 Seguridad

  • Sin credenciales maestras: Se apoya exclusivamente en Application Passwords con autenticación HTTP Basic sobre TLS/HTTPS.

  • Protección de .env: El archivo .env está expresamente excluido en .gitignore para evitar filtraciones accidentales de credenciales.

  • Validación de entradas: Todos los slugs, IDs y contenidos HTML son sanitizados y validados antes de transmitirse a la REST API de WordPress.

  • Permisos de usuario: Cada endpoint respeta los roles y capacidades del usuario autenticado en WordPress (edit_posts, manage_categories, manage_options).


👨‍💻 Autor y Contacto

Creado y mantenido por Rodrigo Ernesto Hernandez.

Si buscas consultoría, integración personalizada de agentes de IA con WordPress, desarrollo a medida o automatización de flujos de trabajo editoriales para tu empresa, puedes contactarme directamente:

¿Te resulta útil este proyecto? Dale una ⭐ en GitHub y compártelo.


📄 Licencia

Este proyecto es de código abierto y está distribuido bajo la Licencia MIT. Creado por Rodrigo Ernesto Hernandez (© 2026). Consulta el archivo LICENSE para más detalles.

Available Tools

17 tools
actualizar_configuracionB

Actualiza opciones generales de WordPress (Título, Tagline, Zona Horaria, Logo o Favicon).

Args: titulo: Nuevo título para el blog (opcional). descripcion: Nuevo subtítulo o lema (tagline) del sitio (opcional). zona_horaria: Identificador de zona horaria (ej. 'America/Santiago') (opcional). site_logo_id: Media ID de la imagen para el logotipo oficial del sitio (opcional). site_icon_id: Media ID de la imagen para el icono/favicon del sitio (opcional).

Returns: Confirmación de las configuraciones modificadas.

Inputs: titulo, descripcion, site_icon_id, site_logo_id, +1 more. Returns: result

actualizar_postB

Actualiza atributos específicos de un post existente en WordPress (título, contenido, extracto, slug, portada, categorías, etiquetas o estado).

Args: post_id: ID del post a modificar en WordPress. titulo: Nuevo título (opcional). contenido_html: Nuevo cuerpo en HTML (opcional). extracto: Nuevo extracto descriptivo (opcional). slug: Nuevo slug para la URL (opcional). imagen_portada_id: Media ID de la imagen destacada (opcional). categorias: Lista de IDs de categorías a asignar (opcional). etiquetas: Lista de IDs de etiquetas a asignar (opcional). estado: 'draft', 'publish', 'pending', etc. (opcional).

Returns: Confirmación de los campos actualizados y enlace de la publicación.

Inputs: post_id (required), slug, estado, titulo, +5 more. Returns: result

administrar_pluginA

Permite activar, desactivar, instalar o eliminar un plugin en WordPress.

Args: plugin_slug: Slug o clave del plugin. Para instalar: slug del directorio de WordPress.org (ej. 'classic-editor'). Para activar/desactivar/eliminar: clave del plugin (ej. 'akismet/akismet'). accion: Una de las siguientes acciones: 'activar', 'desactivar', 'instalar', 'eliminar'.

Returns: Mensaje con el resultado de la operación.

Inputs: accion (required), plugin_slug (required). Returns: result

gestionar_categoriaA

Gestiona categorías en WordPress: listar, crear, actualizar o eliminar, con soporte para descripciones SEO y vinculación Polylang.

Args: accion: 'listar', 'crear', 'actualizar', o 'eliminar'. nombre: Nombre de la categoría (para crear/actualizar). slug: Slug amigable para la URL (opcional). descripcion: Descripción temática para SEO y GEO/AEO (opcional). categoria_id: ID de la categoría (requerido para actualizar o eliminar). idioma: 'es' o 'en' (opcional, para vincular en Polylang). categoria_traduccion_id: ID de la categoría hermana en el otro idioma (opcional).

Returns: Listado de categorías o confirmación de la operación realizada.

Inputs: accion (required), slug, idioma, nombre, +3 more. Returns: result

gestionar_etiquetaA

Gestiona etiquetas (tags) en WordPress: listar, crear, actualizar o eliminar, con soporte para descripciones SEO y vinculación Polylang.

Args: accion: 'listar', 'crear', 'actualizar', o 'eliminar'. nombre: Nombre de la etiqueta (para crear/actualizar). slug: Slug amigable para la URL (opcional). descripcion: Descripción de la tecnología o concepto para SEO (opcional). etiqueta_id: ID de la etiqueta (requerido para actualizar o eliminar). idioma: 'es' o 'en' (opcional, para vincular en Polylang). etiqueta_traduccion_id: ID de la etiqueta hermana en el otro idioma (opcional).

Returns: Listado de etiquetas o confirmación de la operación realizada.

Inputs: accion (required), slug, idioma, nombre, +3 more. Returns: result

gestionar_postA

Gestiona el ciclo de vida de una publicación en WordPress (publicar, volver a borrador o eliminar).

Args: post_id: ID del post en WordPress. accion: 'publicar' (status='publish'), 'borrador' (status='draft'), o 'eliminar' (borrado definitivo).

Returns: Confirmación de la acción realizada con la URL actualizada del post.

Inputs: accion (required), post_id (required). Returns: result

leer_contexto_blogA

Obtiene los artículos publicados más recientes del blog en texto plano.

Permite al agente comprender el tono editorial, estilo y temas recientemente cubiertos para evitar contenido duplicado. Soporta filtrado por idioma (es/en).

Args: limite: Cantidad de artículos a consultar (por defecto 5, máx 20). idioma: Código de idioma opcional según Polylang ('es' para español, 'en' para inglés).

Returns: Resumen estructurado con ID, fecha, título, link y extracto de cada publicación.

Inputs: idioma, limite. Returns: result

moderar_comentarioB

Modifica el estado de un comentario o lo elimina.

Args: comentario_id: ID del comentario en WordPress. accion: 'aprobar' (approve), 'pendiente' (hold), 'spam', 'papelera' (trash), o 'eliminar_definitivo' (borrado irreversible).

Returns: Confirmación del cambio de estado.

Inputs: accion (required), comentario_id (required). Returns: result

obtener_configuracionesA

Obtiene las configuraciones y metadatos generales del sitio web (título, descripción, URL, email administrativo, zona horaria, formato de fecha e idioma del sitio).

Returns: Resumen de las opciones configuradas en WordPress.

Inputs: no named parameters. Returns: result

publicar_borrador_wpA

Crea un nuevo post o actualiza uno existente en WordPress en estado 'draft' (borrador).

Soporta categorías, etiquetas técnicas, slug SEO, extracto descriptivo, imagen de portada y asignación/vinculación de idioma en Polylang.

Args: titulo: Título del post. contenido_html: Cuerpo completo del post en HTML limpio (h2, p, code, etc.). imagen_portada_id: ID devuelto previamente por 'subir_imagen_portada' (opcional). categorias: Lista de IDs de categorías de WP (ej. [132, 137]). etiquetas: Lista de IDs de etiquetas de WP (ej. [147, 157]). slug: Slug amigable para la URL del post (ej. 'caddy-docker-microservices'). extracto: Resumen breve del artículo para meta-descripción y feeds (opcional). idioma: Código del idioma ('es' o 'en') para Polylang (opcional). post_traduccion_id: ID del post en el otro idioma para vincularlos como traducciones (opcional). post_id: ID del post existente a actualizar (si se omite, crea un post nuevo).

Returns: Confirmación con ID del post, título, estado y enlaces directos de previsualización y edición.

Inputs: titulo (required), contenido_html (required), slug, idioma, +6 more. Returns: result

purgar_cache_sitioA

Purga de inmediato las cachés del servidor (WP Super Cache, Docket Cache y OPcache) para que las publicaciones, cambios de menú, widgets y taxonomías se reflejen en el acto.

Returns: Confirmación de las cachés purgadas y timestamp.

Inputs: no named parameters. Returns: result

responder_comentarioB

Publica una respuesta a un comentario específico de un post.

Args: comentario_id: ID del comentario padre al que se responde. post_id: ID del post donde se encuentra el comentario. contenido: Texto de la respuesta.

Returns: Confirmación con el ID del nuevo comentario generado.

Inputs: post_id (required), contenido (required), comentario_id (required). Returns: result

revisar_comentariosA

Lista los comentarios del blog según su estado de moderación.

Args: estado: Filtro por estado: 'all' (todos), 'hold' (pendientes de revisión), 'approve' (aprobados), 'spam' o 'trash' (papelera). limite: Número máximo de comentarios a devolver (por defecto 10, máx 30).

Returns: Listado con ID del comentario, ID del post, autor, fecha, estado y contenido.

Inputs: estado, limite. Returns: result

revisar_pluginsA

Obtiene la lista completa de plugins instalados en WordPress, su estado (activo/inactivo), versión actual, y opcionalmente verifica si hay actualizaciones en WordPress.org.

Args: verificar_actualizaciones: Si es True, consulta el repositorio oficial de WordPress.org para ver si la versión instalada está actualizada.

Returns: Reporte consolidado de todos los plugins instalados.

Inputs: verificar_actualizaciones. Returns: result

subir_imagen_portadaA

Sube una imagen a la biblioteca de medios de WordPress para ser usada como portada.

El argumento 'origen_imagen' puede ser:

  1. Una ruta a un archivo local en disco (ej. 'C:\imagenes\portada.jpg').

  2. Una URL pública directa a la imagen (ej. 'https://.../imagen.jpg').

  3. Una cadena codificada en Base64.

Args: origen_imagen: Ruta local, URL HTTP/HTTPS o string en base64 de la imagen. nombre_archivo: Nombre con el que se guardará en WordPress (opcional, ej. 'ia-portada.jpg'). texto_alt: Texto alternativo para SEO y accesibilidad (opcional).

Returns: Diccionario con el resultado, ID asignado en WordPress y URL pública: {"status": "success", "id": 1045, "url": "https://..."}

Inputs: origen_imagen (required), texto_alt, nombre_archivo.

vincular_terminos_polylangB

Vincula dos términos taxonómicos (categorías o etiquetas) en Polylang Free para que se reconozcan como versiones traducidas en Español e Inglés.

Args: termino_id_es: ID del término en español. termino_id_en: ID del término en inglés. taxonomia: 'category' para categorías o 'post_tag' para etiquetas.

Returns: Confirmación del enlace en Polylang.

Inputs: termino_id_en (required), termino_id_es (required), taxonomia. Returns: result

vincular_traducciones_polylangB

Vincula dos artículos existentes en WordPress para que Polylang los reconozca como la versión en Español y la versión en Inglés del mismo artículo.

Args: post_id_es: ID del artículo en español. post_id_en: ID del artículo en inglés.

Returns: Confirmación del enlace entre ambas traducciones.

Inputs: post_id_en (required), post_id_es (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 17 tools

    Disambiguation3/5

    Most tools are clearly distinct (settings vs. media vs. plugins vs. comments), but three post tools overlap: publicar_borrador_wp can both create and update via post_id, actualizar_post updates many of the same fields including estado, and gestionar_post also changes status/delete. An agent could reasonably be unsure whether to update a post with publicar_borrador_wp, actualizar_post, or gestionar_post.

    Naming Consistency4/5

    Nearly all names follow a Spanish verb_noun pattern (obtener_configuraciones, actualizar_post, gestionar_categoria, revisar_comentarios), which is predictable. Minor deviations exist: the _wp suffix on publicar_borrador_wp, singular vs. plural (revisar_plugins / administrar_plugin), and English nouns (post, plugin) mixed with Spanish verbs.

    Tool Count4/5

    17 tools is slightly above the ideal range but each covers a distinct area (posts, taxonomies, translations, media, plugins, comments, settings, cache). The set is well-scoped for a full WordPress management server rather than padded.

    Completeness4/5

    Core lifecycle is well covered: post create/update/publish/delete, category and tag CRUD, comment list/moderate/reply, plugin list/manage, media upload, settings get/update, and cache purge. Minor gaps remain, such as fetching a single post by ID, listing/deleting media, and menu or user management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers