vk-mcp-ru
MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи
Установка
uvx vk-mcp-ruЗапуск релиза с PyPI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер собран из официальной схемы VK API и дает агенту каталог методов бизнес-разделов: сообщества, товары и заказы, записи на стене, реклама, статистика, диалоги, лид-формы, фото, видео и документы. Агент ищет метод словами, читает описание параметров и вызывает его. Чтение идет сразу, запись требует подтверждения, необратимые действия вроде удаления товара или бана в сообществе подтверждаются дважды. Ключи лежат локально в ~/.ru-mcp/cabinets.json, телеметрии нет. Для Claude Desktop есть установка файлом .mcpb без терминала.
Для кого. Для SMM-специалистов, маркетологов и владельцев бизнеса во ВКонтакте.
Подходит, если
- Нужно свести заказы и товары магазина сообщества в таблицу
- Нужна статистика сообщества и постов за период
- Нужно разобрать непрочитанные диалоги и подготовить ответы на согласование
Не подходит, если
- Нужно работать с личной страницей, а не с сообществом или приложением
- Агент не должен публиковать и отправлять сообщения клиентам
Пример запроса к агенту
Собери статистику сообщества за сентябрь и топ-5 постов по охватуОграничения
Нужен сервисный ключ приложения VK или токен сообщества с правами market, messages, ads, stats, лишние права лучше не выдавать. Сервер дает общий механизм поиска и вызова методов, а не отдельные функции под каждый сценарий. Для установки через .mcpb нужен Python 3.10 или новее.
Как отключить. Удалите сервер из конфигурации клиента или расширение в Claude Desktop, удалите ~/.ru-mcp/cabinets.json и отзовите токен в настройках VK.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| VK_TOKEN обязательная, секрет | Сервисный ключ приложения VK или токен сообщества |
Проверка безопасности
- Публикует записи, отправляет сообщения клиентам и меняет рекламные кампании
- Часть методов необратима: удаление товаров, записей, баны
- Токен сообщества дает доступ к переписке с клиентами
Коротко о README
README описывает сервер для VK API, каталог которого собран из официальной схемы VKCOM/vk-api-schema. Два пути установки: файл .mcpb для Claude Desktop или uvx с конфигурацией. Приведена карта методов по разделам с разбивкой на чтение, запись и необратимые, пример поиска и вызова метода в чате и типовые задачи. Описаны безопасность, команда doctor, родственные серверы автора и политика конфиденциальности.
Частые вопросы
Какой токен нужен?
Сервисный ключ приложения с dev.vk.com или токен сообщества с правами только на нужные разделы.
Как проверить, что все работает?
Команда uvx vk-mcp-ru doctor покажет, сколько методов загрузилось и найдены ли ключи, а с флагом --live сделает один реальный запрос на чтение.
Похожие
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети
Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском