# WordPress MCP Server

MCP (Model Context Protocol) сервер для управления WordPress постами через ChatGPT.

## Что это?

Позволяет ChatGPT создавать, обновлять, получать и удалять посты на вашем WordPress сайте.

## Быстрый старт

### 1. Скопируйте файлы на сервер

```bash
# На вашем Ubuntu сервере создайте директорию
mkdir -p ~/wordpress-mcp-project
cd ~/wordpress-mcp-project

# Скопируйте туда эти файлы:
# - mcp_sse_server.py
# - requirements.txt
# - install.sh
```

### 2. Настройте WordPress credentials

Откройте `mcp_sse_server.py` и измените:

```python
WORDPRESS_URL = "https://your-wordpress-site.com/"
WORDPRESS_USERNAME = "your-username"
WORDPRESS_PASSWORD = "your-password"
```

### 3. Запустите установку

```bash
chmod +x install.sh
sudo ./install.sh
```

Скрипт автоматически:
- Установит все зависимости
- Создаст виртуальное окружение Python
- Установит Python пакеты
- Создаст systemd сервис
- Запустит MCP сервер
- Установит Cloudflare Tunnel для HTTPS
- Выдаст HTTPS URL для подключения к ChatGPT

### 4. Подключите к ChatGPT

1. Откройте ChatGPT
2. Settings → Connectors → New Connector
3. Укажите:
   - **Name:** WordPress MCP
   - **URL:** `https://your-url.trycloudflare.com/sse` (из вывода install.sh)
   - **Authentication:** No authentication
4. Сохраните

### 5. Используйте!

Попросите ChatGPT:
```
Напиши статью про AI на 300 слов и опубликуй на моём WordPress сайте
```

## Архитектура

```
ChatGPT
  ↓ HTTPS/SSE
Cloudflare Tunnel
  ↓ HTTP
FastAPI MCP Server (port 8000)
  ↓ HTTPS
WordPress REST API
  ↓
WordPress Site
```

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

1. **create_post** - Создать новый пост
   - Параметры: title, content, excerpt (опционально), status (publish/draft/private)
   
2. **update_post** - Обновить существующий пост
   - Параметры: post_id, title (опционально), content (опционально), excerpt (опционально)
   
3. **get_posts** - Получить список постов
   - Параметры: per_page (1-100, по умолчанию 10), page (по умолчанию 1)
   
4. **delete_post** - Удалить пост
   - Параметры: post_id

## Управление

### Проверка статуса
```bash
sudo systemctl status wordpress-mcp-server
```

### Просмотр логов
```bash
sudo journalctl -u wordpress-mcp-server -f
```

### Перезапуск
```bash
sudo systemctl restart wordpress-mcp-server
```

### Получить HTTPS URL
```bash
cat ~/cloudflared.log | grep "https://"
```

### Перезапустить Cloudflare Tunnel
```bash
pkill cloudflared
nohup cloudflared tunnel --url http://localhost:8000 > ~/cloudflared.log 2>&1 &
sleep 5
cat ~/cloudflared.log | grep "https://"
```

## Troubleshooting

### Сервер не запускается

```bash
# Проверьте логи
sudo journalctl -u wordpress-mcp-server -n 50

# Проверьте порт
sudo netstat -tlnp | grep 8000
```

### ChatGPT не подключается

```bash
# Проверьте Cloudflare Tunnel
cat ~/cloudflared.log | grep "https://"

# Протестируйте URL
curl https://your-url.trycloudflare.com/health
```

### 401 ошибка при создании поста

Проверьте WordPress credentials в `mcp_sse_server.py`. Убедитесь, что:
- URL правильный и заканчивается на `/`
- Username и password корректные
- У пользователя есть права на создание постов
- WordPress REST API включен

### Ошибка "WordPress client not initialized"

Сервер не смог инициализировать WordPress клиент. Проверьте:
- Логи сервера: `sudo journalctl -u wordpress-mcp-server -n 50`
- Доступность WordPress сайта
- Правильность credentials

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

⚠️ **Важно:**
- WordPress credentials хранятся в коде - используйте Application Password
- Нет аутентификации на MCP endpoint - добавьте API ключ для production
- Cloudflare бесплатный туннель может быть нестабилен

### Рекомендации для production:

1. **Используйте Application Password вместо основного пароля:**
   - В WordPress: Users → Profile → Application Passwords
   - Создайте новый Application Password для MCP
   
2. **Добавьте переменные окружения:**
   ```bash
   # Создайте .env файл
   echo "WORDPRESS_URL=https://your-site.com/" > .env
   echo "WORDPRESS_USERNAME=your-username" >> .env
   echo "WORDPRESS_PASSWORD=your-app-password" >> .env
   ```

3. **Добавьте API Key аутентификацию:**
   - Генерируйте уникальный API ключ
   - Проверяйте header `X-API-Key` на каждом запросе

4. **Используйте HTTPS:**
   - Настройте Nginx/Apache с SSL сертификатом
   - Используйте Let's Encrypt для бесплатных SSL сертификатов

## Требования

- Ubuntu 20.04+
- Python 3.10+
- WordPress с REST API (включен по умолчанию в WordPress 4.7+)
- Root или sudo доступ

## Расширение функционала

### Добавление новых инструментов

Чтобы добавить новые инструменты (например, работа с категориями):

1. Добавьте метод в класс `WordPressMCP`
2. Добавьте Tool в функцию `handle_list_tools()`
3. Добавьте обработку в функцию `handle_call_tool()`

Пример:
```python
async def get_categories(self):
    url = f"{self.api_base}/categories"
    response = await self.client.get(url)
    return response.json()
```

## Примеры использования

### Создание статьи через ChatGPT:
```
Пользователь: Напиши статью про Model Context Protocol на 500 слов и опубликуй

ChatGPT: Создаю статью...
[Использует create_post]
Статья опубликована на https://your-site.com/mcp-protocol/
```

### Получение последних постов:
```
Пользователь: Покажи последние 5 постов

ChatGPT: [Использует get_posts]
1. "MCP Protocol..." - https://your-site.com/mcp/
2. "AI Revolution" - https://your-site.com/ai-revolution/
...
```

### Создание черновика:
```
Пользователь: Создай черновик статьи про Python

ChatGPT: [Использует create_post со status="draft"]
Черновик создан! ID: 124
```

## Мониторинг

Для продакшена рекомендуется добавить:
- Prometheus метрики (количество запросов, ошибок, latency)
- Healthcheck endpoints
- Алерты при падении сервиса
- Логирование в централизованную систему (ELK, Loki)

## Лицензия

MIT - используйте свободно!

## Поддержка

При возникновении проблем:
1. Проверьте логи: `sudo journalctl -u wordpress-mcp-server -f`
2. Проверьте статус: `sudo systemctl status wordpress-mcp-server`
3. Протестируйте WordPress API напрямую:
   ```bash
   curl -u "username:password" https://your-site.com/wp-json/wp/v2/posts
   ```

## Авторы

Created with ❤️ using Model Context Protocol

## Ссылки

- [MCP Documentation](https://modelcontextprotocol.io/)
- [WordPress REST API](https://developer.wordpress.org/rest-api/)
- [FastAPI Documentation](https://fastapi.tiangolo.com/)