MCP WordPress CrunchTools

Un servidor MCP (Model Context Protocol) seguro para la gestión de contenido de WordPress. Diseñado para desarrolladores que publican sobre su trabajo.

Descripción general

• Seguro por defecto: Validación integral de entradas, protección de credenciales y prevención de SSRF

• Sin servicios de terceros: Se ejecuta localmente mediante stdio, tus credenciales nunca salen de tu máquina

• Multiplataforma: Funciona en Linux, macOS y Windows

• Actualizado automáticamente: GitHub Actions supervisa CVEs y actualiza dependencias

• Containerizado: Disponible en quay.io/crunchtools/mcp-wordpress

Related MCP server: TypeScript WordPress MCP Server

Convención de nombres

Características

• 30 herramientas para entradas, páginas, medios y comentarios

• Centrado en la seguridad: Credenciales protegidas, validación de entradas, prevención de SSRF

• Flujo de trabajo para desarrolladores: Publicación programada, revisiones, búsqueda

• Integración sencilla: Funciona con Claude Code y otros clientes MCP

Instalación

Con uvx (recomendado)

uvx mcp-wordpress-crunchtools

Con pip

pip install mcp-wordpress-crunchtools
mcp-wordpress-crunchtools

Con contenedor

# Create a shared upload directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads

podman run -v ~/.local/share/mcp-uploads-downloads:/tmp/mcp-uploads:z \
  -e WORDPRESS_URL=https://example.com \
  -e WORDPRESS_USERNAME=admin \
  -e WORDPRESS_APP_PASSWORD='xxxx xxxx xxxx xxxx' \
  quay.io/crunchtools/mcp-wordpress

Nota sobre SELinux: Usa :z (minúscula, compartido) en lugar de :Z (mayúscula, privado). Los servidores MCP se ejecutan como procesos stdio de larga duración. Con :Z, los archivos copiados en el directorio después de iniciar el contenedor no tendrán la etiqueta MCS privada del contenedor y serán invisibles dentro del contenedor. La opción :z establece un contexto container_file_t compartido que todos los contenedores y el host pueden leer/escribir.

Consejo: Usa el mismo directorio compartido (~/.local/share/mcp-uploads-downloads/) en varios servidores MCP en contenedores (p. ej., mcp-wordpress y mcp-gemini) para que los archivos generados estén disponibles inmediatamente para subir sin copiarlos.

Desde el código fuente

git clone https://github.com/crunchtools/mcp-wordpress.git
cd mcp-wordpress
uv sync --all-extras
uv run mcp-wordpress-crunchtools

Configuración

Establece estas variables de entorno:

Crear una contraseña de aplicación

1. Inicia sesión en el administrador de WordPress

2. Ve a Usuarios → Perfil

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

4. Introduce un nombre (p. ej., "MCP Server") y haz clic en Añadir nueva

5. Copia la contraseña generada (se muestra una sola vez)

Uso con Claude Code

Con uvx (recomendado)

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- uvx mcp-wordpress-crunchtools

Con pip

pip install mcp-wordpress-crunchtools

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- mcp-wordpress-crunchtools

Con contenedor

# Create a shared upload directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- podman run -i --rm \
        -v ~/.local/share/mcp-uploads-downloads:/tmp/mcp-uploads:z \
        -e WORDPRESS_URL \
        -e WORDPRESS_USERNAME \
        -e WORDPRESS_APP_PASSWORD \
        quay.io/crunchtools/mcp-wordpress

Herramientas disponibles

Herramientas del sitio

Herramientas de entradas

Herramientas de páginas

Herramientas de medios

Herramientas de comentarios

Ejemplos

Crear una entrada en borrador

Create a new WordPress post titled "My Technical Article" with the content below. Keep it as a draft.

Programar una entrada

Update post ID 123 to publish on December 25, 2024 at 10:00 AM.

Subir una imagen

Upload this image to WordPress and set the alt text to "Architecture diagram".

Buscar y moderar comentarios

List all comments in "hold" status and approve the legitimate ones.

Seguridad

• Protección de credenciales: Todas las credenciales se almacenan como SecretStr, nunca se registran

• Prevención de SSRF: La ruta de la API REST está codificada, no se puede sobrescribir

• Validación de entradas: Todas las entradas se validan mediante modelos Pydantic

• Límite de velocidad: Gestiona los límites de velocidad de WordPress correctamente

• Aplicación de TLS: Todas las solicitudes usan HTTPS con validación de certificados

• Límites de tamaño: El tamaño de la respuesta se limita a 10MB para evitar problemas de memoria

• Tiempo de espera: Todas las solicitudes expiran después de 30 segundos

Desarrollo

# Install dev dependencies
uv sync --all-extras

# Run tests
uv run pytest

# Run linting
uv run ruff check src tests

# Run type checking
uv run mypy src

# Format code
uv run ruff format src tests

Licencia

AGPL-3.0-or-later

Créditos

Creado por crunchtools.com