Servidor MCP de WordPress completo

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA interactuar con sitios de WordPress a través de la API REST de WordPress. Este servidor proporciona herramientas para gestionar todos los aspectos de WordPress mediante programación, incluyendo entradas, usuarios, comentarios, categorías, etiquetas y endpoints personalizados.

Características

Gestión de correos

• Crear, recuperar, actualizar y eliminar publicaciones de WordPress

• Filtrar publicaciones por varios parámetros

• Soporte de paginación para listados de publicaciones

Gestión de usuarios

• Recuperar información del usuario por ID o inicio de sesión

• Actualizar los detalles del usuario

• Eliminar usuarios

Gestión de comentarios

• Crear, recuperar, actualizar y eliminar comentarios

• Filtrar comentarios por publicación

• Soporte de paginación para listados de comentarios

Gestión de taxonomía

• Administrar categorías y etiquetas

• Crear, recuperar, actualizar y eliminar taxonomías

• Buscar categorías y etiquetas por slug

Información del sitio

• Recuperar información general del sitio de WordPress

Solicitudes personalizadas

• Compatibilidad con puntos finales de API REST personalizados

• Métodos HTTP personalizados (GET, POST, PUT, DELETE)

• Datos y parámetros personalizados

Related MCP server: WordPress MCP Server

Prerrequisitos

• Node.js v18 o superior

• Un sitio de WordPress con API REST habilitada

• Contraseña de la aplicación WordPress para autenticación

Instalación

1. Clonar este repositorio:

git clone [repository-url]
cd wordpress-mcp-server

2. Instalar dependencias:

npm install

3. Construir el servidor:

npm run build

Configuración de WordPress

Antes de utilizar el servidor, debes configurar tu sitio de WordPress:

1. Asegúrese de que su sitio de WordPress tenga habilitada la API REST (habilitada de forma predeterminada en WordPress 4.7+)

2. Crear una contraseña para la aplicación:

   • Inicie sesión en su panel de administración de WordPress

   • Vaya a Usuarios → Perfil

   • Desplácese hacia abajo hasta "Contraseñas de la aplicación".

   • Introduzca un nombre para la aplicación (por ejemplo, "Servidor MCP")

   • Haga clic en "Agregar nueva contraseña de aplicación"

   • Copia la contraseña generada (no podrás volver a verla)

Configuración de MCP

Agregue el servidor a su archivo de configuración de MCP (generalmente ubicado en ~/AppData/Roaming/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["path/to/wordpress-mcp-server/build/index.js"]
    }
  }
}

Herramientas disponibles

Gestión de correos

1. crear_publicación

Crea una nueva publicación de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• title (obligatorio): Título de la publicación

• content (obligatorio): Publicar contenido

• status (opcional): Estado de la publicación ('borrador', 'publicar' o 'privado', el valor predeterminado es 'borrador')

Ejemplo:

{
  "tool": "create_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "title": "My First Post",
  "content": "Hello, world!",
  "status": "draft"
}

2. obtener_publicaciones

Recupera publicaciones de WordPress con paginación.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• perPage (opcional): Número de publicaciones por página (predeterminado: 10)

• page (opcional): Número de página (predeterminado: 1)

• customParams (opcional): parámetros de consulta adicionales

Ejemplo:

{
  "tool": "get_posts",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "perPage": 5,
  "page": 1
}

3. actualización_publicación

Actualiza una publicación existente de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• postId (obligatorio): ID de la publicación a actualizar

• title (opcional): Título de la nueva publicación

• content (opcional): contenido de nueva publicación

• status (opcional): Estado de la nueva publicación ('borrador', 'publicar' o 'privado')

Ejemplo:

{
  "tool": "update_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "postId": 123,
  "title": "Updated Title",
  "content": "Updated content",
  "status": "publish"
}

4. eliminar_publicación

Elimina una publicación de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• postId (obligatorio): ID de la publicación a eliminar

Ejemplo:

{
  "tool": "delete_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "postId": 123
}

Gestión de usuarios

1. obtener_usuarios

Recupera usuarios de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• perPage (opcional): Número de usuarios por página (predeterminado: 10)

• page (opcional): Número de página (predeterminado: 1)

2. obtener_usuario

Recupera un usuario específico de WordPress por ID.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• userId (obligatorio): ID del usuario a recuperar

3. obtener_usuario_por_inicio_de_sesión

Recupera un usuario de WordPress por nombre de inicio de sesión.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• userLogin (obligatorio): Nombre de inicio de sesión del usuario a recuperar

Gestión de comentarios

1. obtener_comentarios

Recupera comentarios de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• perPage (opcional): Número de comentarios por página (predeterminado: 10)

• page (opcional): Número de página (predeterminado: 1)

• postIdForComment (opcional): Filtrar comentarios por ID de publicación

2. crear_comentario

Crea un nuevo comentario en una publicación.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• postIdForComment (obligatorio): ID de la publicación a comentar

• commentContent (obligatorio): Contenido del comentario

• customData (opcional): datos de comentarios adicionales

Gestión de categorías y etiquetas

1. obtener_categorías

Recupera categorías de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• perPage (opcional): Número de categorías por página (predeterminado: 10)

• page (opcional): Número de página (predeterminado: 1)

2. crear_categoría

Crea una nueva categoría de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• categoryName (obligatorio): Nombre de la categoría a crear

• customData (opcional): Datos de categoría adicionales (descripción, padre, etc.)

Solicitudes personalizadas

1. solicitud personalizada

Realiza una solicitud personalizada a cualquier punto final de la API REST de WordPress.

Parámetros:

• siteUrl (obligatorio): la URL de su sitio de WordPress

• username (obligatorio): nombre de usuario de WordPress

• password (obligatoria): contraseña de la aplicación WordPress

• customEndpoint (obligatorio): ruta del punto final de la API

• customMethod (opcional): método HTTP ('GET', 'POST', 'PUT', 'DELETE', predeterminado: 'GET')

• customData (opcional): Datos para solicitudes POST/PUT

• customParams (opcional): parámetros de URL para solicitudes GET

Ejemplo:

{
  "tool": "custom_request",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "customEndpoint": "wp/v2/media",
  "customMethod": "GET",
  "customParams": {
    "per_page": 5
  }
}

Formato de respuesta

Todas las herramientas devuelven respuestas en el siguiente formato:

Respuesta de éxito

{
  "success": true,
  "data": {
    // WordPress API response data
  },
  "meta": {
    // Optional metadata (pagination info, etc.)
  }
}

Respuesta de error

{
  "success": false,
  "error": "Error message here"
}

Consideraciones de seguridad

• Utilice siempre URL HTTPS para su sitio de WordPress

• Utilice contraseñas de aplicaciones en lugar de su contraseña principal de WordPress

• Mantenga seguras las contraseñas de sus aplicaciones y no las comparta

• Considere usar roles y capacidades de WordPress para limitar el acceso

• Rotar periódicamente las contraseñas de las aplicaciones

Desarrollo

Para contribuir al desarrollo:

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Ejecutar pruebas (cuando estén disponibles)

5. Enviar una solicitud de extracción

Para el modo de desarrollo con recompilación automática:

npm run dev

Licencia

Este proyecto está licenciado bajo la licencia ISC.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.