MCP WordPress CrunchTools

Безопасный MCP-сервер (Model Context Protocol) для управления контентом WordPress. Предназначен для разработчиков, публикующих материалы о своей работе.

Обзор

Этот MCP-сервер разработан с учётом следующих принципов:

• Безопасен по умолчанию — комплексная проверка входных данных, защита учётных данных и предотвращение SSRF

• Без сторонних сервисов — работает локально через stdio, ваши учётные данные никогда не покидают вашу машину

• Кроссплатформенный — работает на Linux, macOS и Windows

• Автоматически обновляется — GitHub Actions отслеживают CVE и обновляют зависимости

• Контейнеризирован — доступен на quay.io/crunchtools/mcp-wordpress

Related MCP server: TypeScript WordPress MCP Server

Соглашение об именовании

Возможности

• 30 инструментов для записей, страниц, медиафайлов и комментариев

• Ориентированность на безопасность: защита учётных данных, проверка входных данных, предотвращение SSRF

• Рабочий процесс разработчика: отложенная публикация, ревизии, поиск

• Простая интеграция: работает с Claude Code и другими MCP-клиентами

Установка

С помощью uvx (рекомендуется)

uvx mcp-wordpress-crunchtools

С помощью pip

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

С помощью контейнера

# 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

Примечание по SELinux: используйте :z (строчная, общая) вместо :Z (заглавная, приватная). MCP-серверы работают как долгоживущие процессы stdio. При использовании :Z файлы, скопированные в каталог после запуска контейнера, не будут иметь приватную метку MCS контейнера и будут невидимы внутри контейнера. Флаг :z устанавливает общий контекст container_file_t, который доступен для чтения/записи всем контейнерам и хосту.

Совет: используйте один и тот же общий каталог (~/.local/share/mcp-uploads-downloads/) для нескольких MCP-контейнерных серверов (например, mcp-wordpress и mcp-gemini), чтобы сгенерированные файлы были сразу доступны для загрузки без копирования.

Из исходного кода

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

Конфигурация

Задайте следующие переменные окружения:

Создание пароля приложения

1. Войдите в админ-панель WordPress

2. Перейдите в Пользователи → Профиль

3. Прокрутите до Пароли приложений

4. Введите имя (например, «MCP Server») и нажмите Добавить новый

5. Скопируйте сгенерированный пароль (отображается один раз)

Использование с Claude Code

С помощью uvx (рекомендуется)

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

С помощью 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

С помощью контейнера

# 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

Доступные инструменты

Инструменты для сайта

Инструменты для записей

Инструменты для страниц

Инструменты для медиафайлов

Инструменты для комментариев

Примеры

Создание черновика записи

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

Отложенная публикация записи

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

Загрузка изображения

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

Поиск и модерация комментариев

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

Безопасность

• Защита учётных данных: все учётные данные хранятся как SecretStr, никогда не логируются

• Предотвращение SSRF: путь REST API жёстко задан, его нельзя переопределить

• Проверка входных данных: все входные данные проверяются через модели Pydantic

• Ограничение скорости: корректно обрабатывает ограничения скорости WordPress

• Принудительное использование TLS: все запросы используют HTTPS с проверкой сертификатов

• Ограничение размера: размер ответа ограничен 10 МБ для предотвращения проблем с памятью

• Тайм-аут: все запросы завершаются по тайм-ауту через 30 секунд

Разработка

# 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

Лицензия

AGPL-3.0-or-later

Авторы

Создано crunchtools.com