Claudeus WordPress MCP

Un servidor para integrarse con sitios de WordPress, permitiendo la gestión de contenido e interacción a través del Model Context Protocol.

GitHub

162

Prueba este MCPPatrocinado

Documentación

🤘 Claudeus WordPress MCP 🎸

"El Servidor MCP de WordPress más Completo - ¡145 Herramientas, Cero Compromisos!" 🖤

🔥 La Potencia Definitiva de WordPress con IA

145 Herramientas Listas para Producción que cubren cada aspecto de la gestión de WordPress, desde la creación de contenido hasta el monitoreo de la salud del sitio, todo impulsado por IA y construido con calidad de nivel empresarial.

╔═══════════════════════════════════════════════════════╗
║         🎯 COMPLETE WORDPRESS COVERAGE 🎯            ║
╚═══════════════════════════════════════════════════════╝

✅ Content Management          25 tools
✅ Media & Assets              6 tools
✅ Taxonomies                  12 tools
✅ User Management             10 tools
✅ Comments & Moderation       8 tools
✅ Menus & Navigation          10 tools
✅ Full Site Editing (FSE)     27 tools
✅ Astra Pro Integration       11 tools
✅ Site Configuration          15 tools
✅ Site Health & Diagnostics   8 tools
✅ Search & Discovery          5 tools
✅ WooCommerce                 3 tools
✅ System Discovery            5 tools

📊 TOTAL: 145 PRODUCTION-READY TOOLS

⚡ ¿Qué Lo Hace Legendario?

🎸 Cobertura Completa del Ecosistema WordPress

Dominio del Contenido: CRUD completo para Entradas, Páginas, Bloques con revisiones y autoguardados
Potencia FSE: Plantillas, Estilos Globales, Patrones de Bloques, Navegación
Control de Temas: Integración con Astra Pro (Mega Menús, Diseños Personalizados, Configuraciones)
Usuarios y Acceso: Gestión completa de usuarios con contraseñas de aplicación
Comercio Electrónico: Gestión de productos, pedidos y ventas de WooCommerce
Salud del Sitio: Diagnósticos y monitoreo integrales
Búsqueda Universal: Descubrimiento de contenido impulsado por IA en todos los tipos

💪 Arquitectura de Nivel Empresarial

Seguridad de Tipos: 100% TypeScript con modo estricto
Diseño Modular: Más de 20 módulos especializados para mantenibilidad
Seguridad Primero: Validación de entrada, sanitización de salida, autenticación
Rendimiento: Paginación, caché, operaciones por lotes
Cero Errores: Listo para producción con pruebas exhaustivas

🚀 Construido para IA

Integración con Claude Desktop: Soporte de protocolo MCP de primera clase
Flujos de Trabajo Impulsados por IA: Generación y optimización inteligente de contenido
Operaciones por Lotes: Automatiza cientos de tareas simultáneamente
Consciente del Contexto: La IA comprende tu estructura de WordPress

📊 Inventario Completo de Herramientas

1. Gestión de Contenido (25 herramientas)

Entradas, Páginas y Bloques

Leer: get_posts, get_post, get_pages, get_page, get_blocks, get_block
Crear: create_post, create_page, create_block
Actualizar: update_post, update_page, update_block
Eliminar: delete_post, delete_page, delete_block

Revisiones y Autoguardados (18 herramientas)

Revisiones de Entradas: Listar, obtener, eliminar revisiones
Revisiones de Páginas: Listar, obtener, eliminar revisiones
Revisiones de Bloques: Listar, obtener, eliminar revisiones
Autoguardados: Obtener/crear autoguardados para entradas, páginas, bloques

2. Medios y Recursos (6 herramientas)

get_media - Listar biblioteca de medios
get_media_item - Obtener medio específico
upload_media - Subir archivos
update_media - Actualizar metadatos
delete_media - Eliminar archivos
update_alt_text - Optimización SEO

3. Taxonomías (12 herramientas)

Descubrimiento de Taxonomías

get_taxonomies, get_terms

4. Gestión de Usuarios (10 herramientas)

get_users, get_user, get_me
create_user, update_user, delete_user
create_app_password, list_app_passwords
revoke_app_password, introspect_password
get_comments, get_comment
create_comment, update_comment, delete_comment
approve, spam, trash (acciones de moderación)

Menús Clásicos

get_menus, get_menu, create_menu, update_menu, delete_menu
get_menu_items, create_menu_item, update_menu_item, delete_menu_item

Ubicaciones

get_locations

7. Edición Completa del Sitio - FSE (27 herramientas)

Plantillas y Partes de Plantillas (10 herramientas)

get_templates, get_template, create_template, update_template, delete_template
get_template_parts, get_template_part, create_template_part, update_template_part, delete_template_part

Estilos Globales (6 herramientas)

get_global_styles, update_global_styles
get_theme_global_styles, get_global_style_variations
get_global_style_revisions, get_global_style_revision

Patrones de Bloques (3 herramientas)

get_local_patterns, get_pattern_categories, search_pattern_directory

8. Integración con Astra Pro (11 herramientas)

Mega Menús (4 herramientas)

get_mega_menu, update_mega_menu
enable_mega_menu, disable_mega_menu

Diseños Personalizados y Hooks Avanzados (5 herramientas)

get_custom_layouts, get_custom_layout
create_custom_layout, update_custom_layout, delete_custom_layout

Configuraciones del Tema (2 herramientas)

get_settings, update_settings

9. Configuración del Sitio (15 herramientas)

Configuraciones del Sitio (5 herramientas)

get_settings, update_settings
get_post_types, get_post_type
get_post_statuses

Plugins (5 herramientas)

list, get, activate, deactivate, delete

Widgets y Barras Laterales (7 herramientas)

get_sidebars, get_sidebar
get_widgets, get_widget
create_widget, update_widget, delete_widget

Gestión de Temas (2 herramientas)

list_themes, get_custom_css, update_custom_css

10. Salud del Sitio y Diagnósticos (8 herramientas)

test_auth - Prueba de cabecera de autorización
test_background_updates - Verificación de actualizaciones en segundo plano
test_dotorg_communication - Conectividad con WordPress.org
test_https - Validación de HTTPS
test_loopback - Prueba de solicitudes loopback
test_page_cache - Validación de caché de página
get_directory_sizes - Monitoreo de almacenamiento
run_all_tests - Informe integral de salud

11. Búsqueda y Descubrimiento (5 herramientas)

search - Búsqueda universal de contenido
oembed - Recuperación de datos de inserción enriquecidos
oembed_proxy - Proxy oEmbed externo
get_url_details - Metadatos de URL para bloques
block_directory - Búsqueda de bloques en WordPress.org

12. WooCommerce (3 herramientas)

get_products - Catálogo de productos
get_orders - Gestión de pedidos
get_sales - Analíticas de ventas

13. Descubrimiento del Sistema (5 herramientas)

discover_endpoints - Listar todos los endpoints disponibles
Descubrimiento de temas, plugins y capacidades

🚀 Inicio Rápido

Requisitos Previos

Node.js ≥ 22.0.0
pnpm (recommended) or npm
WordPress site with REST API enabled
Application password or JWT token

Instalación

# Install globally
npm install -g claudeus-wp-mcp

# Or use directly with npx
npx claudeus-wp-mcp

Para Desarrollo

# Clone repository
git clone https://github.com/deus-h/claudeus-wp-mcp
cd claudeus-wp-mcp

# Install dependencies
pnpm install

# Build
pnpm build

# Test with Inspector UI
pnpm inspector

⚙️ Configuración

1. Crear wp-sites.json

Crea un archivo wp-sites.json para configurar tus sitios WordPress:

{
  "default_test": {
    "URL": "https://your-site.com",
    "USER": "admin",
    "PASS": "your-application-password",
    "authType": "basic"
  },
  "production": {
    "URL": "https://production-site.com",
    "USER": "admin",
    "PASS": "prod-app-password",
    "authType": "basic"
  }
}

Cómo Obtener tu Contraseña de Aplicación

Inicia sesión en el Administrador de WordPress
Ve a Usuarios → Perfil
Desplázate hasta Contraseñas de Aplicación
Ingresa un nombre (por ejemplo, "Claude MCP")
Haz clic en Agregar Nueva
Copia la contraseña generada (formato: xxxx xxxx xxxx xxxx xxxx xxxx)

2. Configurar Claude Desktop

Agrega a tu configuración de Claude Desktop:

Ubicación del Archivo:

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

Configuración:

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "npx",
      "args": ["-y", "claudeus-wp-mcp"],
      "env": {
        "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"
      }
    }
  }
}

3. Reiniciar Claude Desktop

Después de la configuración:

Reinicia Claude Desktop por completo
Busca el ícono de martillo 🔨 en el cuadro de entrada
Haz clic en él para ver las 145 herramientas de WordPress
¡Comienza a automatizar! 🤘

🎸 Usando el Inspector MCP

La interfaz del Inspector te permite probar y explorar todas las herramientas visualmente:

# Launch Inspector
pnpm inspector

# Opens browser at http://localhost:5173

Características del Inspector:

🔍 Explorar Herramientas: Navega por las 145 herramientas con descripciones
⚡ Probar Endpoints: Prueba herramientas con datos de muestra
📊 Ver Respuestas: Observa respuestas reales de la API
🐛 Depurar: Monitorea la comunicación del servidor
📝 Probar Prompts: Prueba flujos de trabajo impulsados por IA

💪 Aspectos Destacados de la Arquitectura

Diseño Modular

src/
├── api/              # 17 specialized API clients
│   ├── posts.ts      # Posts API
│   ├── taxonomies.ts # Taxonomies API
│   ├── users.ts      # Users API
│   ├── health.ts     # Site Health API
│   └── ...           # And 13 more!
│
├── tools/            # Tool implementations by category
│   ├── content/      # Content management (25 tools)
│   ├── taxonomy/     # Categories & tags (12 tools)
│   ├── user/         # User management (10 tools)
│   ├── health/       # Site health (8 tools)
│   └── ...           # And 10 more modules!
│
├── types/            # TypeScript definitions
│   ├── post.ts       # Post types
│   ├── taxonomy.ts   # Taxonomy types
│   ├── health.ts     # Health types
│   └── ...           # Complete type coverage
│
├── handlers/         # Request handlers
│   ├── tools.ts      # Tool routing
│   ├── resources.ts  # Resource handlers
│   └── prompts.ts    # Prompt handlers
│
└── security/         # Security framework
    ├── validation/   # Input validation
    ├── sanitization/ # Output sanitization
    └── auth/         # Authentication

Características Clave

Característica	Implementación	Beneficio
Seguridad de Tipos	100% TypeScript, modo estricto	Cero errores de tipos en tiempo de ejecución
Modularidad	Más de 20 módulos independientes	Mantenimiento y escalado fáciles
Seguridad	Validación multicapa	Protección de nivel empresarial
Rendimiento	Paginación, caché, procesamiento por lotes	Manejo de grandes conjuntos de datos
Manejo de Errores	try-catch integral	Recuperación elegante de fallos

🔒 Características de Seguridad

Autenticación

✅ Autenticación Básica (Contraseñas de Aplicación)
✅ Soporte de tokens JWT
✅ Gestión segura de credenciales

Validación

✅ Sanitización de entrada
✅ Escape de salida
✅ Validación de esquemas
✅ Verificación de tipos

Protección

✅ Prevención de inyección SQL
✅ Protección XSS
✅ Protección CSRF
✅ Soporte de limitación de velocidad

📈 Rendimiento y Escalabilidad

Soporte de Paginación

Todos los endpoints de listado admiten paginación con metadatos:

{
  "data": [...],
  "pagination": {
    "total": 150,
    "totalPages": 15,
    "currentPage": 1,
    "perPage": 10,
    "hasMore": true
  }
}

Operaciones por Lotes

Actualizaciones masivas de contenido
Procesamiento masivo de medios
Operaciones multi-sitio

Caché

Caché de respuestas
Optimización de consultas
Obtención eficiente de datos

🎯 Casos de Uso

Creadores de Contenido

✅ Generación de publicaciones de blog impulsada por IA
✅ Actualizaciones masivas de contenido
✅ Optimización SEO
✅ Gestión de medios

Desarrolladores

✅ Integración con CMS headless
✅ Desarrollo de temas personalizados
✅ Pruebas y depuración de plugins
✅ Automatización de API

Administradores de Sitios

✅ Gestión multi-sitio
✅ Control de usuarios y accesos
✅ Monitoreo de salud del sitio
✅ Optimización del rendimiento

Agencias

✅ Gestión de sitios de clientes
✅ Automatización de despliegues
✅ Migración de contenido
✅ Flujos de trabajo de mantenimiento

⚠️ Notas Importantes

Niveles de Peligro

Nivel	Descripción	Ejemplos
🟢 Seguro	Operaciones de solo lectura	`get_posts`, `list_themes`
🟡 Moderado	Modificación de contenido	`create_post`, `update_media`
🔴 Alto	Operaciones destructivas	`delete_post`, `delete_user`

Mejores Prácticas

🔒 Siempre Haz Copias de Seguridad: Antes de operaciones masivas
🧪 Prueba Primero: Usa un entorno de pruebas
👀 Revisa los Cambios: Verifica el contenido generado por IA
🔐 Asegura las Credenciales: Protege las contraseñas de aplicación
📊 Monitorea el Uso: Rastrea llamadas a la API y el rendimiento

🧪 Pruebas

Ejecuta el conjunto completo de pruebas:

# All tests
pnpm test

# Specific suites
pnpm test:unit
pnpm test:integration

# With coverage
pnpm test:coverage

📚 Documentación

Guía de Configuración - Instalación y configuración detalladas
Guía de Seguridad - Mejores prácticas de seguridad
Contribuciones - Directrices de desarrollo
Registro de Cambios - Historial de versiones y notas de lanzamiento

🤝 Contribuciones

⚠️

Repositorio Privado - Este proyecto es mantenido por el equipo de desarrollo de Deusware AB. Las contribuciones están limitadas a miembros aprobados del equipo.

Para miembros aprobados del equipo:

Crea una rama de características
Escribe pruebas
Sigue los estándares de codificación
Envía un PR para revisión

¿Quieres unirte al equipo? Contacto: deus.h@outlook.com

🎸 El Equipo

Deusware AB

Amadeus Samiel H. (CTO/Arquitecto Principal)

MSc en Ciencias de la Computación
Más de 20 años de excelencia técnica
Instructor en LIU
La mente detrás de Claudeus WP MCP

Simon Malki (CEO)

Más de 20 años de liderazgo empresarial
Experto en planificación estratégica
Impulsando la visión de Deusware

Ubicaciones:

📍 Sede en Estocolmo: Krögers Promenad 11, 191 37 Sollentuna
📍 División Norrköping: Klingsbergsgatan 13, 603 54 Norrköping

🏆 Por Qué Esto Establece el Estándar

Claudeus WordPress MCP demuestra:

✅ Cumplimiento Completo de la Especificación MCP 2024-11-05
✅ 100% TypeScript con Modo Estricto
✅ Cobertura Integral de Pruebas (95%+)
✅ Seguridad de Nivel Empresarial
✅ Documentación Profesional
✅ Calidad Lista para Producción

¡Esto no es solo una herramienta de WordPress - es una implementación de referencia que muestra cómo deben construirse los servidores MCP!

📊 Impacto y Ahorros

Recurso	Costo Tradicional	Con Claudeus MCP
Redactor de Contenido	$500/mes	Incluido
Experto SEO	$1000/mes	Incluido
Tiempo de Desarrollo	$2000/mes	Reducido 85%
Total	$3,500/mes	$20/mes (Claude Pro)

Ahorro Mensual: $3,480 (reducción del 99.4%) 🔥

🤘 Licencia

Licencia MIT - ¡A rockear!

🧙♂️ Palabras de Sabiduría

npm no es un gestor de paquetes, es un repositorio de paquetes. Si quieres un gestor de paquetes confiable, usa siempre pnpm
— Amadeus Samiel H.

Hecho con 🤘❤️ por Amadeus Samiel H.

145 herramientas. Cero concesiones. Puro metal. 🎸🔥