Servidor MCP para WordPress

Un servidor de Model Context Protocol (MCP) listo para producción para la integración con WordPress. Permite que agentes de IA interactúen con sitios web de WordPress mediante herramientas estructuradas.

Características

• 39 herramientas de WordPress que cubren entradas, páginas, medios, usuarios, categorías, etiquetas, plugins, temas, menús y WooCommerce

• Autenticación segura mediante contraseñas de aplicación de WordPress

• Protección de operaciones destructivas que requiere confirmación explícita

• Manejo estructurado de errores con códigos de error detallados

• Soporte de paginación para operaciones de listado

• Configuración basada en entorno para las credenciales

Related MCP server: WordPress MCP Server

Requisitos previos

• Node.js 18+

• Sitio de WordPress con la API REST habilitada

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

Instalación

npm install
npm run build

Configuración

Crea un archivo .env en la raíz del proyecto:

WORDPRESS_URL=https://your-wordpress-site.com
WORDPRESS_USERNAME=your-username
WORDPRESS_APP_PASSWORD=your-application-password

Generación de contraseñas de aplicación

1. Ve a Administración de WordPress → Usuarios → Tu perfil

2. Desplázate hasta "Contraseñas de aplicación"

3. Introduce un nombre (por ejemplo, "Servidor MCP")

4. Haz clic en "Añadir nueva contraseña de aplicación"

5. Copia la contraseña generada

Uso

Ejecutar el servidor

# Development
npm run dev

# Production
npm start

Integración con clientes MCP

Añade a la configuración de tu cliente MCP:

{
  "mcp": {
    "wordpress": {
      "type": "local",
      "command": ["node", "/path/to/wordpress-mcp-server/dist/index.js"],
      "environment": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Herramientas disponibles

Operaciones del sitio

Operaciones con entradas

Operaciones con páginas

Operaciones con medios

Operaciones con usuarios

Operaciones de taxonomía

Operaciones con plugins

Operaciones con temas

Operaciones con menús

Operaciones de WooCommerce

Seguridad

• Las credenciales se almacenan en variables de entorno (nunca se exponen en la salida)

• Las operaciones destructivas requieren confirmación explícita

• Las operaciones de solo lectura se ejecutan automáticamente

• Autenticación para todos los recursos protegidos

Desarrollo

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

Estructura del proyecto

wordpress-mcp-server/
├── src/
│   ├── index.ts          # Entry point
│   ├── server.ts         # MCP server setup
│   ├── client/
│   │   └── wordpress.ts  # WordPress API client
│   ├── tools/
│   │   ├── index.ts      # Tool registration
│   │   ├── definitions.ts # Tool schemas
│   │   ├── site.ts       # Site tools
│   │   ├── posts.ts      # Post tools
│   │   ├── pages.ts      # Page tools
│   │   ├── media.ts      # Media tools
│   │   ├── users.ts      # User tools
│   │   ├── taxonomies.ts # Taxonomy tools
│   │   ├── plugins.ts    # Plugin tools
│   │   ├── themes.ts     # Theme tools
│   │   ├── menus.ts      # Menu tools
│   │   └── woocommerce.ts # WooCommerce tools
│   ├── validation/
│   │   └── schemas.ts    # Zod validation schemas
│   ├── types/
│   │   └── index.ts      # TypeScript type definitions
│   └── utils/
│       ├── config.ts     # Environment configuration
│       └── logger.ts     # Structured logging
├── package.json
├── tsconfig.json
└── .env.example

Licencia

MIT