VK-бот с MCP-сервером товаров
Product MCP + VK Бот
Учебный проект: VK-бот на естественном языке ищет и редактирует товары в SQLite через свой REST-сервер инструментов и OpenAI
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Бот отвечает клиентам сообщества VK автоматически без модерации
- Инструменты редактирования и удаления товаров доступны через LLM-интерпретацию запроса
Установка
Ручная установка
Клонируй репозиторий, поставь зависимости в mcp_server и VK_bot отдельными pip install -r requirements.txt, создай .env с VK_API_TOKEN, PROXY_OPENAI_API_KEY, MCP_SERVER_URL и OPENAI_BASE_URL, запусти mcp_server/server.py и VK_bot/bot.py в двух терминалах.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект собирает демонстрационный магазин: SQLite-база из 102 товаров в 6 категориях, сервер инструментов на FastAPI с эндпоинтами GET /tools и POST /call для поиска, добавления, редактирования и удаления товаров, безопасного калькулятора и пагинации, и VK-бот, который через VK Long Poll получает сообщения, распознает намерение через OpenAI (модель gpt-4o-mini через прокси proxyapi.ru) и вызывает нужный инструмент сервера. Автор сам называет серверную часть MCP-сервером, но это собственный REST-протокол проекта с эндпоинтами tools и call, а не реализация стандартного MCP по JSON-RPC, поэтому подключить его напрямую к Claude Code, Cursor или другому MCP-клиенту без доработки не получится.
Для кого. Для тех, кто изучает архитектуру бота с вызовом инструментов через LLM на примере VK и хочет готовый учебный каркас.
Подходит, если
- Нужен учебный пример связки VK-бота, LLM и сервера инструментов с базой SQLite
- Нужен каркас, который можно переделать под свой каталог товаров и свой мессенджер
- Интересна конкретная реализация: Long Poll, память диалога на 10 сообщений, безопасный калькулятор
Не подходит, если
- Ищете стандартный MCP-сервер для подключения к Claude Code или Cursor: этот протокол свой, а не JSON-RPC MCP
- Нужен готовый продакшен-магазин, а не учебный проект со 102 тестовыми товарами
Пример запроса к агенту
В сообщении боту: найди смартфон от 5000 до 10000 рублей в категории электроникаОграничения
Несмотря на название, сервер инструментов не реализует протокол MCP: это собственный REST API с GET /tools и POST /call, рассчитанный на VK-бота этого же проекта. Нужны токен сообщества VK и ключ OpenAI через прокси proxyapi.ru, доступность которого не гарантирована. База данных тестовая, лицензия в репозитории не указана.
Как отключить. Остановите процессы server.py и bot.py и удалите файл .env с токенами.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| VK_API_TOKEN обязательная, секрет | Токен сообщества VK для приема сообщений через Long Poll. |
| PROXY_OPENAI_API_KEY обязательная, секрет | Ключ OpenAI, используемый через прокси-сервис proxyapi.ru. |
| MCP_SERVER_URL обязательная | Адрес запущенного сервера инструментов, по умолчанию http://127.0.0.1:8000. |
Проверка безопасности
- Бот отвечает клиентам сообщества VK автоматически без модерации
- Инструменты редактирования и удаления товаров доступны через LLM-интерпретацию запроса
Коротко о README
README описывает проект как решение проблемы ручного управления каталогом и повторяющихся вопросов клиентов сообщества VK: бот отвечает мгновенно, администратор правит ассортимент без доступа к базе. Перечислены технологии (Python, FastAPI, SQLite, vk_api, OpenAI через proxyapi.ru), архитектура из четырех блоков, скриншоты демонстрации, инструкция по установке в два виртуальных окружения и таблица примеров команд боту.
Частые вопросы
Можно ли подключить этот MCP-сервер к Claude Code как обычный MCP?
Нет напрямую: сервер использует собственные эндпоинты /tools и /call, а не протокол MCP по JSON-RPC, который ждут стандартные MCP-клиенты.
Нужен ли отдельный ключ OpenAI?
Да, проект использует OpenAI gpt-4o-mini через прокси-сервис proxyapi.ru, ключ задается в .env.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма