SellerGuide MCP Server

MCP-сервер для агентства SellerGuide. Позволяет ИИ-ассистентам (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

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

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

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

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

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

1. Зайди на github.com, создай новый репозиторий sellerguide-mcp (можно приватный).
2. Локально:

   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 (можно через 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:

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 → 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:

{
  "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 — PR в раздел Community Servers
• smithery.ai — добавь через их форму
• mcp.so — крупнейший каталог MCP-серверов