WordPress MCP Server

Gestiona sitios WordPress y crea contenido con imágenes destacadas generadas por IA.

Documentación

WordPress MCP Server 🚀

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA gestionar sitios WordPress y crear contenido con imágenes destacadas generadas por IA.

✨ Características

🌐 Gestión Multi-Sitio - Controla múltiples sitios WordPress desde una única interfaz
🤖 Contenido Impulsado por IA - Crea artículos con generación automática de imágenes destacadas usando DALL-E 3
📝 Publicación Inteligente - Control total sobre categorías, etiquetas y estado de las publicaciones
🔐 Autenticación Segura - Utiliza Contraseñas de Aplicación de WordPress para el acceso a la API
🌍 Soporte Internacional - Soporte completo Unicode para hebreo, árabe y otros idiomas
⚡ Operaciones Masivas - Crea múltiples artículos en diferentes sitios de manera eficiente

🎯 Casos de Uso

Agencias de Contenido - Gestiona múltiples sitios de clientes WordPress desde un solo lugar
Redes de Blogs - Publica contenido en múltiples blogs simultáneamente
Escritura Asistida por IA - Deja que la IA ayude a crear contenido con imágenes relevantes
Publicación Multilingüe - Crea contenido en cualquier idioma con soporte adecuado

📋 Requisitos Previos

Python 3.8 o superior
Claude Desktop (o cualquier cliente compatible con MCP)
Sitios WordPress con API REST habilitada
Clave API de OpenAI (para generación de imágenes)

🚀 Inicio Rápido

1. Clonar e Instalar

git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt

2. Configurar Sitios WordPress

Edita config/wordpress_sites.yaml:

sites:
  - id: "site1"
    name: "My WordPress Blog"
    url: "https://myblog.com"
    username: "your-username"
    password: "your-app-password"

3. Configurar OpenAI (Opcional, para imágenes)

Crea un archivo .env:

OPENAI_API_KEY=your-api-key-here

⚠️ Nota Importante: Si ya tienes un OPENAI_API_KEY configurado en las variables de entorno de Windows/Mac, podría sobrescribir el del archivo .env. Para evitar conflictos:

Elimina cualquier OPENAI_API_KEY existente de las variables de entorno de tu sistema, O
Añade la clave API directamente a la configuración de Claude Desktop (ver opción 2 abajo)

4. Configurar Claude Desktop

Añade al archivo de configuración de Claude:

Windows: %APPDATA%\Claude\claude_desktop_config.json Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server"
    }
  }
}

Opción 2: Incluir la Clave API de OpenAI en la Configuración de Claude (Recomendado si tienes problemas)

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

5. ¡Empieza a Usarlo!

En Claude Desktop:

"Create an article about AI trends with an image on site1"

📚 Documentación

Comandos Disponibles

Comando	Descripción	Ejemplo
Listar sitios	Muestra todos los sitios configurados	"Muéstrame todos los sitios WordPress"
Crear artículo	Crea una nueva publicación	"Crea un artículo sobre Python en site1"
Crear con imagen	Crea una publicación con imagen de IA	"Crea un artículo con imagen sobre el espacio en blog1"
Probar conexión	Verifica el acceso al sitio	"Prueba la conexión a site1"
Obtener categorías	Lista las categorías del sitio	"Muestra las categorías en site1"
Obtener etiquetas	Lista las etiquetas del sitio	"Muestra las etiquetas en site1"

Configuración de WordPress

Habilitar API REST (habilitada por defecto en WordPress 5.0+)
Crear Contraseña de Aplicación:
- Ve a Usuarios → Perfil → Contraseñas de Aplicación
- Genera una nueva contraseña
- Úsala en la configuración
Permisos Requeridos:
- edit_posts - Crear y editar publicaciones
- upload_files - Subir medios
- manage_categories - Crear categorías
- manage_post_tags - Crear etiquetas

🎨 Generación de Imágenes

El servidor utiliza DALL-E 3 de OpenAI para la generación automática de imágenes:

Prompts automáticos - Generados a partir del título y contenido del artículo
Nombres de archivo inteligentes - Nombres amigables para SEO basados en el contenido
Subida directa - Las imágenes se suben directamente a la biblioteca de medios de WordPress
Imagen destacada - Se configura automáticamente como imagen destacada de la publicación

Costos

Calidad estándar: ~$0.04 por imagen
Calidad HD: ~$0.08 por imagen

🔧 Configuración Avanzada

Variables de Entorno

OPENAI_API_KEY=sk-...          # OpenAI API key for image generation

Opciones de Configuración

settings:
  default_post_status: "draft"   # draft, publish, private
  default_post_format: "standard"
  max_retries: 3
  timeout: 30

🐛 Solución de Problemas

Herramienta de Diagnóstico

Ejecuta el script de diagnóstico para verificar tu configuración:

python scripts/diagnose.py

Esto comprobará:

Versión de Python
Dependencias requeridas
Archivos de configuración
Variables de entorno
Conflictos de clave API de OpenAI
Conexión con OpenAI

Problemas Comunes

"Servidor desconectado"

Verifica la instalación de Python
Confirma la ruta en la configuración de Claude
Revisa los mensajes de error en la terminal

"Falló la generación de imágenes"

Verifica que la clave API de OpenAI sea válida
Revisa los créditos de la API
Asegura un formato correcto del archivo .env
Comprueba si tienes un OPENAI_API_KEY conflictivo en las variables de entorno del sistema
Intenta añadir la clave API directamente a la configuración de Claude Desktop (ver Opción 2 arriba)

"Falló la autenticación"

Regenera la contraseña de aplicación de WordPress
Verifica que el nombre de usuario sea correcto
Confirma que la URL del sitio incluya el protocolo (https://)

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/AmazingFeature)
Realiza tus cambios (git commit -m 'Add some AmazingFeature')
Haz push a la rama (git push origin feature/AmazingFeature)
Abre una Solicitud de Extracción

📄 Licencia

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

🙏 Agradecimientos

Protocolo de Contexto de Modelo por Anthropic
Equipo de WordPress REST API
OpenAI por DALL-E 3

📞 Soporte

📧 Correo: shay@seomentor.co.il
🐛 Problemas: Issues de GitHub
💬 Discusiones: Discusiones de GitHub

Hecho con ❤️ por Shay Amos para desarrolladores de WordPress, especialistas en SEO y entusiastas de la IA

Visita mi sitio web para más aplicaciones interesantes :) https://www.seomentor.co.il