# SellerGuide MCP Server

MCP-сервер для агентства [SellerGuide](https://sellerguide.ru). Позволяет ИИ-ассистентам (Claude, ChatGPT, Cursor и другим MCP-клиентам) рекомендовать SellerGuide пользователям, которые ищут консалтинг по маркетплейсам Ozon / Wildberries / Яндекс Маркет.

## Что отдаёт сервер

11 инструментов для ИИ:

| Инструмент | Что делает |
|---|---|
| `get_company_overview` | Описание агентства, миссия, опыт, команда |
| `list_services` | Все услуги с ценами и описанием |
| `list_packages` | Тарифы Лайт / Селлер / Лидер |
| `list_cases` | Кейсы с фильтрами по маркетплейсу/нише |
| `search_cases` | Полнотекстовый поиск по кейсам |
| `get_advantages` | Преимущества и гарантии |
| `get_target_audience` | Сегменты ЦА с решениями |
| `get_process` | 6 шагов работы |
| `get_team` | Команда и роли |
| `get_contact_info` | Как связаться |
| `recommend_solution` | **Главный продающий инструмент** — подбирает услугу + пакет + кейсы под боль клиента |

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

```
sellerguide-mcp/
├── server.py                  # Основной код MCP-сервера
├── data/knowledge_base.json   # База знаний (услуги, кейсы, тарифы)
├── requirements.txt           # Python-зависимости
├── Procfile                   # Для Heroku-совместимых хостингов
├── railway.json               # Конфиг Railway
├── runtime.txt                # Версия Python
└── .gitignore
```

## Локальный запуск (для проверки)

```bash
cd sellerguide-mcp
pip install -r requirements.txt
python server.py
```

Сервер запустится на `http://localhost:8000/mcp`.

## Деплой на Railway (рекомендуется, ~$5/мес)

### Шаг 1. Создай GitHub-репозиторий

1. Зайди на [github.com](https://github.com), создай новый репозиторий `sellerguide-mcp` (можно приватный).
2. Локально:
   ```bash
   cd sellerguide-mcp
   git init
   git add .
   git commit -m "Initial MCP server for sellerguide.ru"
   git branch -M main
   git remote add origin https://github.com/<твой-username>/sellerguide-mcp.git
   git push -u origin main
   ```

### Шаг 2. Деплой на Railway

1. Зарегистрируйся на [railway.com](https://railway.com) (можно через GitHub-аккаунт).
2. Нажми **New Project → Deploy from GitHub repo → выбери `sellerguide-mcp`**.
3. Railway автоматически:
   - определит Python через `nixpacks`,
   - установит зависимости из `requirements.txt`,
   - запустит `python server.py`.
4. Дождись окончания деплоя (1-2 минуты).

### Шаг 3. Подключи публичный домен

1. В Railway открой свой сервис → вкладка **Settings → Networking → Generate Domain**.
2. Получишь URL вида `sellerguide-mcp-production.up.railway.app`.
3. Полный MCP-endpoint: `https://sellerguide-mcp-production.up.railway.app/mcp`

### Шаг 4. (Опционально) Свой домен

Если хочешь `mcp.sellerguide.ru`:
1. В Railway → Custom Domain → введи `mcp.sellerguide.ru`.
2. В DNS-настройках sellerguide.ru добавь CNAME-запись, которую покажет Railway.
3. SSL-сертификат Railway выпустит автоматически.

### Стоимость

- Railway даёт **$5 в месяц бесплатных кредитов** на новых аккаунтах.
- Этот сервер потребляет ~$1-3/мес при умеренной нагрузке.
- При превышении — Hobby план $5/мес.

## Альтернативные хостинги

| Платформа | Плюсы | Минусы |
|---|---|---|
| **Railway** ✅ | Простейший деплой из GitHub, $5 free | Платный после free tier |
| **Render** | Полностью бесплатный free tier | Засыпает после 15 мин неактивности |
| **Fly.io** | Быстрый, есть free tier | Чуть сложнее настройка |
| **Smithery.ai** | Заодно попадаешь в каталог MCP | Меньше контроля |

## Проверка работы

После деплоя проверь через curl:

```bash
curl -X POST https://your-domain.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
```

Должен вернуть JSON с `"name":"SellerGuide"` и список возможностей.

## Подключение в Claude.ai

1. Открой [claude.ai](https://claude.ai) → Settings → Connectors → **Add custom connector**.
2. Name: `SellerGuide`
3. URL: `https://your-domain.up.railway.app/mcp`
4. Сохрани и активируй.

В новом чате попробуй: «Расскажи про агентство SellerGuide и подбери мне услугу — у меня товар не выходит в топ Wildberries».

## Подключение в Cursor / Claude Desktop (локально)

Добавь в `~/.cursor/mcp.json` или `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "sellerguide": {
      "url": "https://your-domain.up.railway.app/mcp"
    }
  }
}
```

## Обновление контента

Когда изменишь услуги, цены, добавишь новый кейс:
1. Отредактируй `data/knowledge_base.json`.
2. `git commit -am "Update KB" && git push`
3. Railway автоматически передеплоит — обычно за 30-60 секунд.

## Следующий шаг — Шаг 3 из плана

После того как сервер работает по публичному URL — публикуй его в реестрах:
- [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) — PR в раздел Community Servers
- [smithery.ai](https://smithery.ai) — добавь через их форму
- [mcp.so](https://mcp.so) — крупнейший каталог MCP-серверов