WordPress Docs

Accede a la documentación y herramientas de desarrollo de WordPress.

Documentación

Servidor MCP de WordPress Docs

npm version License: MIT

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona documentación y herramientas de desarrollo de WordPress tanto para Claude Code como para Claude Desktop. Obtén acceso instantáneo a la documentación de WordPress.org, guías de WordPress VIP y referencias de funciones directamente en tus conversaciones de Claude.

🚀 Inicio Rápido

Instalar vía npm (Recomendado)

npm install -g wordpress-docs-claude-mcp

Configurar para Claude Code

Añade a tu archivo de configuración MCP de Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "wordpress-docs": {
      "command": "wordpress-docs-mcp"
    }
  }
}

Configurar para Claude Desktop

Añade a 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-docs": {
      "command": "wordpress-docs-mcp"
    }
  }
}

Reiniciar Claude

Reinicia Claude Code o Claude Desktop para cargar el servidor MCP.

🛠️ Herramientas Disponibles

hello_wp

Herramienta de saludo con temática de WordPress para probar la conectividad del servidor MCP.

  • Parámetros: name (obligatorio) - Nombre para saludar con contexto de WordPress

wp_search_docs

Busca documentación para desarrolladores de WordPress.org con opciones de filtrado.

  • Parámetros:
    • query (obligatorio) - Término de búsqueda para documentación de WordPress
    • type (opcional) - Tipo de contenido: "posts", "functions", "hooks", "classes"

wp_vip_search

Busca documentación de la plataforma WordPress VIP para funciones empresariales.

  • Parámetros:
    • query (obligatorio) - Término de búsqueda para documentación de WordPress VIP
    • section (opcional) - Sección VIP: "all", "getting-started", "infrastructure", "development", "content"

wp_function_lookup

Obtén información detallada sobre funciones, hooks o clases específicas de WordPress.

  • Parámetros:
    • function_name (obligatorio) - Nombre exacto de la función, hook o clase de WordPress

💡 Ejemplos de Uso

Una vez configurado, puedes pedirle a Claude que use estas herramientas de forma natural:

Buscar Documentación:

  • "Buscar en la documentación de WordPress tipos de contenido personalizados"
  • "Encontrar documentación de WordPress VIP sobre caché"
  • "Consultar información sobre endpoints de la API REST"

Búsqueda de Funciones:

  • "Buscar la función wp_enqueue_script"
  • "Encontrar documentación para get_post"
  • "¿Qué parámetros acepta add_action?"

Consultas Específicas de VIP:

  • "Buscar en la documentación de VIP las mejores prácticas de implementación"
  • "Encontrar información de VIP sobre optimización de rendimiento"
  • "Consultar controles de seguridad de VIP"

🔧 Configuración de Desarrollo

Si quieres contribuir o ejecutar desde el código fuente:

  1. Clonar el repositorio:

    git clone https://github.com/freibergergarcia/wordpress-docs-claude-mcp.git
    cd wordpress-docs-claude-mcp
    
  2. Instalar dependencias:

    npm install
    
  3. Compilar el proyecto:

    npm run build
    
  4. Configurar Claude con la ruta local:

    {
      "mcpServers": {
        "wordpress-docs": {
          "command": "node",
          "args": ["dist/index.js"],
          "cwd": "/absolute/path/to/wordpress-docs-claude-mcp"
        }
      }
    }
    

🧪 Pruebas

Prueba el servidor manualmente (requiere jq para salida formateada):

# List available tools
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | wordpress-docs-mcp | jq

# Test WordPress greeting
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "hello_wp", "arguments": {"name": "Developer"}}}' | wordpress-docs-mcp | jq

# Search WordPress documentation
echo '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "wp_search_docs", "arguments": {"query": "REST API", "type": "posts"}}}' | wordpress-docs-mcp | jq

# Search WordPress VIP documentation
echo '{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "wp_vip_search", "arguments": {"query": "deployment"}}}' | wordpress-docs-mcp | jq

# Look up WordPress function
echo '{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "wp_function_lookup", "arguments": {"function_name": "get_post"}}}' | wordpress-docs-mcp | jq

📚 Documentación

  • Arquitectura MCP - Aprende cómo funcionan los servidores MCP, la integración con Node.js y la comunicación con Claude
  • Guía de Desarrollo - Cómo añadir nuevas herramientas de WordPress y flujo de trabajo de desarrollo

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/AmazingFeature)
  3. Haz commit de tus cambios (git commit -m 'Add some AmazingFeature')
  4. Sube los cambios a la rama (git push origin feature/AmazingFeature)
  5. Abre un Pull Request

📝 Licencia

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

🔗 Enlaces

⚡ Novedades

Versión 1.0.0

  • ✅ Búsqueda de documentación de WordPress.org con filtrado por tipo de contenido
  • ✅ Búsqueda de documentación de WordPress VIP con respaldo de web scraping
  • ✅ Consulta de funciones de WordPress con extracción directa de URL
  • ✅ Manejo integral de errores y validación
  • ✅ Soporte para Claude Code y Claude Desktop
  • ✅ Obtención de documentación en tiempo real (sin contenido en caché o desactualizado)

Hecho con ❤️ para las comunidades de WordPress y Claude