SellerGuide MCP Server

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

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

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

Related MCP server: marketplaces-mcp-ru

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

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/мес.

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

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

После деплоя проверь через 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-серверов