Servidor MCP de WordPress con IA 🚀🤖

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite administrar sitios WordPress con generación de contenido usando IA (Claude/Anthropic) integrada.

✨ Características

🌐 Gestión de WordPress

• Control completo de tu sitio WordPress
• Operaciones CRUD - Lista, crea, actualiza y elimina posts
• Gestión de taxonomías - Categorías y etiquetas
• Gestión de medios - Sube archivos multimedia
• Autenticación segura - Usa contraseñas de aplicación de WordPress

🤖 IA Integrada (Claude/Anthropic)

• Generación automática de contenido - Solo proporciona un prompt, la IA genera todo
• Optimización SEO - Contenido optimizado para buscadores
• Mejora de posts existentes - Optimiza contenido ya publicado
• Multilingüe - Genera contenido en cualquier idioma
• Estilos y tonos personalizables - Profesional, casual, técnico, creativo

🎯 Arquitectura Centralizada

• Tokens del dueño - Los usuarios NO necesitan API keys propias
• Un solo punto de configuración - Tu ANTHROPIC_API_KEY en el servidor
• Escalable - Múltiples usuarios usando tus credenciales de IA
• Más rápido - Todo en una sola llamada desde n8n u otros clientes

🚀 Dos Modos de Uso

1️⃣ Modo MCP (Claude Desktop, Cline, etc.)

Usa el servidor MCP tradicional para integrar con herramientas que soporten el protocolo MCP.

2️⃣ Modo HTTP/REST API (n8n, Zapier, Make.com, etc.) ⭐ NUEVO

Despliega el servidor como una API HTTP en Render y úsalo desde cualquier herramienta:

• n8n - Workflows automatizados
• Zapier/Make.com - Automatizaciones sin código
• Postman - Testing y desarrollo
• Cualquier app - Solo necesitas hacer HTTP requests

👉 Ver guía completa de despliegue en Render

🎯 Casos de Uso

Para Propietarios de SaaS

• Ofrece generación de contenido con IA sin que tus usuarios necesiten API keys
• Controla los costos - Tú pagas y cobras como prefieras
• Integración con n8n - Workflows automatizados perfectos
• Despliega en Render - $7/mes para servicio siempre activo

Para Bloggers y Creadores

• Genera posts completos con un simple prompt
• Optimiza contenido existente automáticamente
• Publicación multilingüe sin esfuerzo
• Automatiza tu blog - Posts diarios automáticos desde n8n

Para Agencias

• Gestiona múltiples sitios WordPress
• Crea contenido en lote con IA
• Automatiza flujos de trabajo completos
• Integra con Google Sheets - Tus clientes solo agregan temas

📋 Requisitos Previos

• Python 3.8 o superior
• Sitio WordPress con REST API habilitado
• Cuenta de Anthropic con API key (para usar Claude)
• Cliente MCP: n8n, Claude Desktop, o cualquier compatible

🚀 Inicio Rápido

1. Clonar e Instalar

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

2. Configurar Variables de Entorno

Crea un archivo .env basándote en .env.example:

# WordPress
WP_URL=https://tu-sitio-wordpress.com
WP_USERNAME=tu-usuario
WP_PASSWORD=tu-contraseña-de-aplicación

# IA - Claude (Anthropic)
ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxx

⚠️ Importante:

• Usa una contraseña de aplicación de WordPress (no tu contraseña normal)
• Tu ANTHROPIC_API_KEY es TUYA (del dueño del servidor)
• Los usuarios finales NO necesitan sus propias API keys

3. Configurar el Cliente MCP

Opción A: Usar con n8n (Recomendado para producción)

1. Instala el nodo MCP en n8n
2. Configura el endpoint:

   Endpoint: http://tu-servidor:puerto/mcp
   Transport: HTTP Streamable
   Authentication: Multiple Headers Auth
   

3. Los usuarios solo envían prompts, tú controlas la IA

Opción B: Usar con Claude Desktop (Para desarrollo)

Añade a tu configuración de Claude Desktop:

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

{
  "mcpServers": {
    "wordpress-ai": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/ruta/a/wpmcp",
      "env": {
        "WP_URL": "https://tu-sitio.com",
        "WP_USERNAME": "usuario",
        "WP_PASSWORD": "contraseña-aplicacion",
        "ANTHROPIC_API_KEY": "sk-ant-api03-xxxxx"
      }
    }
  }
}

4. ¡Comienza a Usar!

Desde n8n:

// Solo envía un prompt
{
  "tool": "generate_post_with_ai",
  "arguments": {
    "prompt": "Escribe un artículo sobre las ventajas de la IA en medicina"
  }
}

Desde Claude Desktop:

"Genera un post sobre tendencias de IA"
"Lista todos los posts"
"Mejora el post 123 para mejor SEO"

📚 Documentación

Herramientas Disponibles

🔹 Gestión Básica de WordPress

Herramienta	Descripción
list_categories	Lista todas las categorías
list_posts	Lista posts con paginación
search_posts	Busca posts por término
create_post	Crea un post manual
update_post	Actualiza post existente
delete_post	Elimina un post
upload_media	Sube archivo multimedia
list_tags	Lista todas las etiquetas
search_tags	Busca etiquetas
create_tag	Crea una etiqueta

🤖 Herramientas con IA (NUEVAS)

Herramienta	Descripción	Ejemplo
generate_post_with_ai	Genera y publica un post completo usando IA	{"prompt": "Artículo sobre blockchain"}
improve_post_with_ai	Mejora un post existente con IA	{"post_id": 123, "improvements": "mejorar SEO"}
generate_content_from_prompt	Genera contenido sin publicar (solo JSON)	{"prompt": "Guía de Python"}

Ejemplos de Uso

Generar Post Completo con IA

{
  "tool": "generate_post_with_ai",
  "arguments": {
    "prompt": "Escribe un artículo completo sobre las ventajas de la inteligencia artificial en la medicina moderna",
    "style": "profesional",
    "tone": "informativo",
    "language": "español",
    "status": "draft"
  }
}

La IA generará automáticamente:

• ✅ Título optimizado para SEO
• ✅ Contenido extenso y bien estructurado (HTML)
• ✅ Extracto atractivo
• ✅ Categorías relevantes
• ✅ Tags apropiados
• ✅ Todo publicado directamente en WordPress

Mejorar Post Existente

{
  "tool": "improve_post_with_ai",
  "arguments": {
    "post_id": 123,
    "improvements": "mejorar SEO, claridad y añadir más ejemplos prácticos"
  }
}

Generar Contenido sin Publicar

{
  "tool": "generate_content_from_prompt",
  "arguments": {
    "prompt": "Tutorial paso a paso sobre instalación de Docker",
    "style": "técnico",
    "tone": "educativo"
  }
}

Parámetros de Personalización

Estilos disponibles:

• profesional - Lenguaje formal y corporativo
• casual - Lenguaje relajado y cercano
• técnico - Lenguaje especializado y preciso
• creativo - Lenguaje original y artístico

Tonos disponibles:

• informativo - Objetivo y educativo
• persuasivo - Convence y motiva a la acción
• educativo - Enseña paso a paso
• entretenido - Divertido y engaging

🔧 Configuración de WordPress

1. Habilitar REST API

Habilitado por defecto en WordPress 5.0+

2. Crear Contraseña de Aplicación

1. Ve a Usuarios → Perfil
2. Baja a Contraseñas de Aplicación
3. Ingresa un nombre (ej: "MCP Server")
4. Copia la contraseña generada

3. Permisos Requeridos

• edit_posts - Crear y editar posts
• upload_files - Subir multimedia
• manage_categories - Gestionar categorías
• manage_post_tags - Gestionar etiquetas

💰 Costos de IA (Claude/Anthropic)

Claude 3.5 Sonnet (Modelo usado)

• Input: ~$3 por 1M tokens
• Output: ~$15 por 1M tokens

Estimación por post:

• Post típico (1000 palabras): ~$0.05 - $0.15
• Post largo (2000+ palabras): ~$0.15 - $0.30

💡 Tip: Como dueño del servidor, tú controlas estos costos y puedes:

• Cobrar a tus usuarios por post generado
• Incluirlo en un plan de suscripción
• Ofrecer X posts gratis por mes

🔄 Cambiar a OpenAI (Opcional)

Si prefieres usar GPT en lugar de Claude:

1. Edita src/ai_content_generator.py
2. Reemplaza el cliente de Anthropic por OpenAI
3. Actualiza .env:

   OPENAI_API_KEY=sk-xxxxxxxxxxxxx
   

4. Actualiza requirements.txt:

   openai>=1.0.0
   

🐛 Solución de Problemas

"Generador de IA no disponible"

• ✅ Verifica que ANTHROPIC_API_KEY esté en .env
• ✅ Verifica que la API key sea válida en console.anthropic.com
• ✅ Reinicia el servidor MCP

"Error generando contenido"

• ✅ Verifica tu saldo de créditos en Anthropic
• ✅ Revisa los logs para ver el error específico
• ✅ Verifica que el prompt sea claro y específico

"Error creando post en WordPress"

• ✅ Verifica los permisos del usuario de WordPress
• ✅ Asegúrate de que el REST API esté habilitado
• ✅ Verifica que las categorías/tags existan o puedan crearse

📊 Arquitectura del Sistema

┌─────────────┐
│   Usuario   │
│   (n8n)     │
└──────┬──────┘
       │ Prompt simple
       ▼
┌─────────────────────────┐
│  Servidor MCP           │
│  ┌──────────────────┐   │
│  │ Tu ANTHROPIC_KEY │   │  ← Tus credenciales
│  └────────┬─────────┘   │
│           ▼             │
│  ┌──────────────────┐   │
│  │  Claude IA       │   │
│  │  (Genera         │   │
│  │   contenido)     │   │
│  └────────┬─────────┘   │
│           ▼             │
│  ┌──────────────────┐   │
│  │  WordPress API   │   │
│  │  (Publica)       │   │
│  └──────────────────┘   │
└─────────────────────────┘
       │
       ▼
┌─────────────┐
│  WordPress  │
│    Blog     │
└─────────────┘

🤝 Contribuir

¡Las contribuciones son bienvenidas!

1. Fork el repositorio
2. Crea tu rama (git checkout -b feature/CaracteristicaIncreible)
3. Commit tus cambios (git commit -m 'Añadir CaracteristicaIncreible')
4. Push a la rama (git push origin feature/CaracteristicaIncreible)
5. Abre un Pull Request

📄 Licencia

MIT License - consulta LICENSE para más detalles.

🙏 Agradecimientos

• Model Context Protocol por Anthropic
• WordPress REST API
• Claude AI por Anthropic
• n8n por la integración MCP

📞 Soporte

• 📧 Email: shay@seomentor.co.il
• 🐛 Issues: GitHub Issues
• 💬 Discusiones: GitHub Discussions

---

Hecho con ❤️ para desarrolladores, SEOs y emprendedores de SaaS

Visita mi sitio: https://www.seomentor.co.il

---

⭐ Diferenciadores Clave

vs. Otras Soluciones MCP WordPress:

✅ IA integrada en el servidor (no en el cliente) ✅ Usuario solo envía prompts (no necesita configurar IA) ✅ Tú controlas los costos de IA ✅ Perfecto para SaaS y servicios escalables ✅ Compatible con n8n para automatización total

Ideal para:

• 🏢 SaaS de generación de contenido
• 🤖 Automatizaciones con n8n
• 📝 Agencias de contenido
• 🚀 Emprendedores que quieren ofrecer IA sin complejidad