WordPress MCP Server

# 🚀 WordPress MCP Server - С ЧЕГО НАЧАТЬ **Главная точка входа в проект** > Это полная система для управления WordPress через ChatGPT с использованием Model Context Protocol (MCP). --- ## 📚 Навигация по документации Документация организована по уровням сложности — выберите подходящий путь: ### 🎯 Для быстрого старта (5-10 минут): - **[QUICK_START.md](QUICK_START.md)** — Запуск за 5 минут (минимальная настройка) ### 📖 Для детальной установки (30-60 минут): - **[SETUP_GUIDE.md](SETUP_GUIDE.md)** — Пошаговая инструкция с объяснениями ### 💡 Для изучения возможностей: - **[EXAMPLES.md](EXAMPLES.md)** — 20+ примеров использования - **[README.md](README.md)** — Главная документация проекта ### ❓ При возникновении проблем: - **[FAQ.md](FAQ.md)** — 30+ частых вопросов и ответов ### 🚀 Для развертывания в production: - **[DEPLOYMENT.md](DEPLOYMENT.md)** — Развертывание на 7 платформах ### 🏗️ Для разработчиков: - **[PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)** — Архитектура проекта - **[CHANGELOG.md](CHANGELOG.md)** — История изменений --- ## ⚡ Экспресс-гайд (если некогда читать) ### Что это? Позволяет ChatGPT создавать, редактировать и удалять посты на вашем WordPress сайте через естественный язык. ### За 3 команды: ```bash # 1. Настройте credentials в mcp_sse_server.py # 2. Запустите установку chmod +x install.sh && sudo ./install.sh # 3. Получите HTTPS URL и подключите к ChatGPT ``` ### Результат: Говорите ChatGPT: *"Напиши статью про AI на 500 слов и опубликуй на моём сайте"* ChatGPT создаст и опубликует статью автоматически! ✨ --- ## 🎓 Выберите свой путь ### Путь 1: "Хочу быстро попробовать" → [QUICK_START.md](QUICK_START.md) - ⏱️ Время: 5-10 минут - 🎯 Цель: Запустить и протестировать - 📝 Уровень: Начинающий ### Путь 2: "Хочу всё понять и настроить" → [SETUP_GUIDE.md](SETUP_GUIDE.md) - ⏱️ Время: 30-60 минут - 🎯 Цель: Полноценная установка с пониманием - 📝 Уровень: Средний ### Путь 3: "Хочу развернуть в production" → [DEPLOYMENT.md](DEPLOYMENT.md) - ⏱️ Время: 1-3 часа - 🎯 Цель: Production-ready установка - 📝 Уровень: Продвинутый --- ## 📦 Что входит в проект ### Основной код: - `mcp_sse_server.py` — MCP сервер на Python (681 строка) - `requirements.txt` — Зависимости Python ### Скрипты управления: - `install.sh` — Автоматическая установка - `start_server.sh` — Ручной запуск сервера - `restart_tunnel.sh` — Перезапуск HTTPS туннеля - `check_status.sh` — Проверка статуса всех компонентов - `uninstall.sh` — Полное удаление ### Документация: - `GET_STARTED.md` — Эта страница (точка входа) - `README.md` — Главная документация - `QUICK_START.md` — Быстрый старт - `SETUP_GUIDE.md` — Детальная инструкция - `EXAMPLES.md` — Примеры использования - `FAQ.md` — Частые вопросы - `DEPLOYMENT.md` — Развертывание - `PROJECT_STRUCTURE.md` — Архитектура - `USAGE_EXAMPLES.md` — Технические примеры - `CHANGELOG.md` — История изменений - `PROJECT_SUMMARY.md` — Итоговая сводка --- ## 🎯 Что вы получите после установки ### 1. MCP Сервер - ✅ Работает на порту 8000 - ✅ Автозапуск через systemd - ✅ Полная интеграция с WordPress REST API ### 2. HTTPS Доступ - ✅ Cloudflare Tunnel (бесплатный) - ✅ Публичный HTTPS URL - ✅ Готов для подключения к ChatGPT ### 3. Управление WordPress - ✅ Создание постов - ✅ Обновление постов - ✅ Получение списка постов - ✅ Удаление постов ### 4. ChatGPT Integration - ✅ SSE endpoint для OpenAI - ✅ JSON-RPC протокол MCP - ✅ 4 готовых инструмента --- ## 🔧 Системные требования ### Минимальные: - **ОС:** Ubuntu 20.04+ (или любой Linux с systemd) - **Python:** 3.10+ - **RAM:** 512 MB - **Диск:** 100 MB - **Доступ:** sudo/root ### WordPress: - **Версия:** 4.7+ (любая с REST API) - **API:** Включен (по умолчанию включен) - **Права:** Пользователь с правами на создание постов - **Auth:** Username + Password (или Application Password) ### Интернет: - **Исходящие:** HTTPS к вашему WordPress - **Входящие:** Не требуются (Cloudflare Tunnel) --- ## 🚦 Быстрая диагностика ### Проверить, всё ли работает: ```bash ./check_status.sh ``` ### Увидеть логи: ```bash # MCP сервер (systemd) sudo journalctl -u wordpress-mcp-server -f # MCP сервер (ручной запуск) tail -f server.log # Cloudflare Tunnel tail -f ~/cloudflared.log ``` ### Перезапустить всё: ```bash # Сервер sudo systemctl restart wordpress-mcp-server # Туннель ./restart_tunnel.sh # Всё вместе sudo systemctl restart wordpress-mcp-server && ./restart_tunnel.sh ``` --- ## 💬 Примеры команд для ChatGPT После подключения попробуйте: ### Простые команды: ``` Создай пост "Hello World" на моём сайте Покажи последние 5 постов Удали пост с ID 123 ``` ### Сложные команды: ``` Напиши статью про AI на 500 слов с SEO-оптимизацией и опубликуй как черновик Найди все посты про Python за последний месяц Создай серию из 3 постов: "JavaScript: Основы", "JavaScript: Функции", "JavaScript: Объекты" ``` --- ## 🎓 Уровни использования ### Уровень 1: Базовый (сразу после установки) - Создание простых постов - Просмотр списка постов - Удаление постов ### Уровень 2: Продвинутый (см. EXAMPLES.md) - Создание постов с HTML - Работа с черновиками - Массовое создание контента - Использование через Python/curl ### Уровень 3: Эксперт (см. DEPLOYMENT.md) - Интеграция с другими системами - Автоматизация через cron - Мониторинг и логирование - Production deployment --- ## 🆘 Нужна помощь? ### Шаг 1: Проверьте FAQ **[FAQ.md](FAQ.md)** содержит 30+ решений типичных проблем. ### Шаг 2: Диагностика ```bash ./check_status.sh # Автоматическая проверка ``` ### Шаг 3: Логи ```bash # Смотрите логи для диагностики sudo journalctl -u wordpress-mcp-server -n 50 ``` ### Шаг 4: Типичные проблемы #### Сервер не запускается: ```bash # Проверьте credentials в mcp_sse_server.py grep "your-wordpress-site" mcp_sse_server.py # Проверьте зависимости source venv/bin/activate pip install -r requirements.txt ``` #### ChatGPT не подключается: ```bash # Получите URL заново ./restart_tunnel.sh # Проверьте доступность curl https://your-url.trycloudflare.com/health ``` #### 401 ошибка: - Проверьте WordPress credentials - Убедитесь, что REST API включен - Используйте Application Password вместо основного --- ## 🎉 Поздравляем! Вы готовы начать работу с WordPress MCP Server! ### Рекомендуемый путь для новичков: 1. **Прочитайте [QUICK_START.md](QUICK_START.md)** (5 минут) 2. **Запустите установку** через `install.sh` 3. **Попробуйте примеры** из [EXAMPLES.md](EXAMPLES.md) 4. **При проблемах** смотрите [FAQ.md](FAQ.md) ### Для опытных пользователей: 1. **[SETUP_GUIDE.md](SETUP_GUIDE.md)** — детальная настройка 2. **[DEPLOYMENT.md](DEPLOYMENT.md)** — production установка 3. **[PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)** — архитектура --- ## 📞 Контакты и поддержка - **GitHub Issues:** Для багов и предложений - **Документация:** Все файлы в корне проекта - **Примеры кода:** `EXAMPLES.md` и `USAGE_EXAMPLES.md` --- ## 📄 Лицензия MIT License - используйте свободно в коммерческих и некоммерческих проектах. --- **Готовы начать?** → [QUICK_START.md](QUICK_START.md) 🚀 **Нужно больше деталей?** → [SETUP_GUIDE.md](SETUP_GUIDE.md) 📖 **Есть вопросы?** → [FAQ.md](FAQ.md) ❓