SkillFoxx
Telegram

VK-бот с MCP-сервером товаров

Product MCP + VK Бот

Учебный проект: VK-бот на естественном языке ищет и редактирует товары в SQLite через свой REST-сервер инструментов и OpenAI

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Бот отвечает клиентам сообщества VK автоматически без модерации
  • Инструменты редактирования и удаления товаров доступны через LLM-интерпретацию запроса
Все причины и проверки
Российский стек

gvoronin7-star/vk-bot-with-mcp-serverАвтор:gvoronin7-star

Установка

Работает в
Сервисы

Ручная установка

Текст для агента

Клонируй репозиторий, поставь зависимости в 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 в двух терминалах.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Бот отвечает клиентам сообщества VK автоматически без модерации
  • Инструменты редактирования и удаления товаров доступны через LLM-интерпретацию запроса

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект собирает демонстрационный магазин: 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

Транспорт
http
Авторизация
не нужна

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

VK_API_TOKEN обязательная, секрет
Токен сообщества VK для приема сообщений через Long Poll.
PROXY_OPENAI_API_KEY обязательная, секрет
Ключ OpenAI, используемый через прокси-сервис proxyapi.ru.
MCP_SERVER_URL обязательная
Адрес запущенного сервера инструментов, по умолчанию http://127.0.0.1:8000.

Ограничения

Несмотря на название, сервер инструментов не реализует протокол MCP: это собственный REST API с GET /tools и POST /call, рассчитанный на VK-бота этого же проекта. Нужны токен сообщества VK и ключ OpenAI через прокси proxyapi.ru, доступность которого не гарантирована. База данных тестовая, лицензия в репозитории не указана.

Как отключить. Остановите процессы server.py и bot.py и удалите файл .env с токенами.

Частые вопросы

Можно ли подключить этот MCP-сервер к Claude Code как обычный MCP?

Нет напрямую: сервер использует собственные эндпоинты /tools и /call, а не протокол MCP по JSON-RPC, который ждут стандартные MCP-клиенты.

Нужен ли отдельный ключ OpenAI?

Да, проект использует OpenAI gpt-4o-mini через прокси-сервис proxyapi.ru, ключ задается в .env.

Обсуждение

Вопросов и отзывов пока нет.

ВКонтакте — все инструменты
Российский стек

MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи

MCP-серверШирокий доступ3
Российский стек

MCP-сервер, автогенерируемый из схемы VK API: больше 180 инструментов с фильтрами по режиму чтение, запись, деньги и по разделам API

MCP-серверШирокий доступ1
Российский стек

MCP для ВКонтакте на собственном сервере: каталог методов VK API, чтение стен и сообществ, сравнение сообществ и запись только после подтверждения человека

MCP-серверШирокий доступ
Российский стек

MCP-сервер для VK Реклама с установщиком под ключ: 136 инструментов, поиск сообществ VK и навык для нескольких агентов сразу

MCP-серверШирокий доступ
Российский стек

MCP-сервер для API ВКонтакте: профили, стены, сообщества, фото, лайки и статистика, публикация постов с подтверждением

MCP-серверШирокий доступ17
Российский стек

Локальный MCP-сервер для VK API: поиск людей и городов, профили, фото и видео с HTML-галереей, пул токенов и кэш SQLite

MCP-серверШирокий доступ

Коротко о README

README описывает проект как решение проблемы ручного управления каталогом и повторяющихся вопросов клиентов сообщества VK: бот отвечает мгновенно, администратор правит ассортимент без доступа к базе. Перечислены технологии (Python, FastAPI, SQLite, vk_api, OpenAI через proxyapi.ru), архитектура из четырех блоков, скриншоты демонстрации, инструкция по установке в два виртуальных окружения и таблица примеров команд боту.

Бейдж для README

Сообщить о проблеме