# wp-mcp-server

MCP-сервер для WordPress с кастомными инструментами:
- Парсинг Telegram-постов
- Поиск на SideQuest
- Создание черновиков через Telegram Parser plugin

## Быстрый старт (готовый .exe)

В `dist/` лежит готовый standalone `.exe` (собран с PyInstaller — включает Python + все зависимости).

1. Скопировать `dist/wp-mcp-server.exe` в `~/.local/bin/`:
   ```
   copy dist\wp-mcp-server.exe %USERPROFILE%\.local\bin\
   ```

2. Проверить:
   ```
   where wp-mcp-server
   ```
   → должен показать `C:\Users\...\.local\bin\wp-mcp-server.exe`

3. В `opencode.jsonc`:
   ```json
   "wp": {
     "type": "local",
     "command": [
       "C:\\Users\\solopnz\\.local\\bin\\wp-mcp-server.exe"
     ],
     "timeout": 120000,
     "enabled": true
   }
   ```

## Установка из исходников (если нет .exe)

```bash
# Установить пакет (зависимости подтянутся из pyproject.toml)
pip install .

# Запустить
wp-mcp-server
```

## Сборка standalone .exe

```bash
pip install pyinstaller
pyinstaller --onefile --name wp-mcp-server src/mcp_server_wordpress/__init__.py
```

Готовый .exe будет в `dist/wp-mcp-server.exe` (~38 MB).

## Переменные окружения

Сервер читает эти переменные (если не заданы — использует значения по умолчанию для onlyvr.ru):

| Переменная | Значение по умолч. | Описание |
|---|---|---|
| `WP_SITE` | `https://onlyvr.ru` | Базовый URL сайта |
| `WP_USER` | `onvr` | Имя пользователя WP |
| `WP_APP_PASSWORD` | `vXOdsQcA25K9JGiGM50Woh4a` | App Password WP |

⚠️ В `opencode.jsonc` можно задать через `env`, но имена переменных должны строго совпадать: `WP_SITE`, `WP_USER`, `WP_APP_PASSWORD` (не `WP_URL`, не `WP_USERNAME`).

## Инструменты MCP

| Инструмент | Описание |
|---|---|
| `wp_create_parser_draft` | Создать черновик поста (парсинг Telegram + картинки из SideQuest) |
| `wp_prepare_post_preview` | Предпросмотр поста из Telegram (без создания) |
| `wp_find_sidequest_app` | Поиск игры на SideQuest по названию |
| `wp_wp_site_info` | Информация о сайте WP |

## Структура проекта

```
wp-mcp-server/
├── dist/                          # Готовый .exe
│   └── wp-mcp-server.exe
├── src/
│   └── mcp_server_wordpress/
│       ├── __init__.py            # Entry point (cli)
│       ├── server.py              # FastMCP сервер + инструменты
│       ├── wordpress.py           # WordPress REST API клиент
│       ├── sidequest.py           # SideQuest API + DuckDuckGo fallback
│       └── tg_client.py           # MCP клиент для tg-mcp-server
├── pyproject.toml
├── README.md
└── .gitignore
```