mcp-vkontakte (ailenreiko1977-tech)
mcp-vkontakte
MCP для ВКонтакте на собственном сервере: каталог методов VK API, чтение стен и сообществ, сравнение сообществ и запись только после подтверждения человека
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- VK-токены дают доступ к личным сообщениям, стенам и сообществам
- Запись и удаление на стенах возможны при выданных правах, хотя выполнение требует подтверждения человека
Установка
- Работает в
- Сервисы
Ручная установка
Подключи MCP-сервер по адресу моего VPS по инструкции из `docs/CLIENTS.md`. Токены VK не запрашивай в чате: пользователь вводит их в защищенном кабинете. Любую запись готовь планом и жди подтверждения человека в браузере.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- VK-токены дают доступ к личным сообщениям, стенам и сообществам
- Запись и удаление на стенах возможны при выданных правах, хотя выполнение требует подтверждения человека
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Прототип версии 0.1.0 на Python 3.12 размещается на собственном VPS и обслуживает нескольких пользователей, у каждого свой токен VK. Агент получает каталог методов из закрепленной официальной схемы VK API с поиском по русским словам и читает стены, профили, сообщества, диалоги, статистику, товары и фотографии в пределах выданных VK разрешений. Два сценария выделяют проект. Первый: изменения и публикации готовятся как план с неизменяемыми параметрами, а выполняются только после того, как человек войдет на отдельную страницу подтверждения в браузере. Модель инструмента для подтверждения не получает. Второй: сравнение сообществ за период с частотой постов, реакциями, медианами, ER по просмотрам, форматами и временем публикаций, с формулами и ограничениями расчета. В проекте шифруются VK-токены и подготовленные действия, проверяются OAuth-аудитория и CSRF, ограничиваются запросы и размеры данных. Развертывание описано с Keycloak и HTTPS в каталоге `docs`.
Для кого. Командам SMM и владельцам сообществ ВКонтакте, которые готовы развернуть свой сервер и хотят, чтобы агент анализировал и готовил публикации без права записи без подтверждения.
Подходит, если
- Два сообщества сравнивают за месяц по частоте постов, реакциям и ER
- Публикацию готовит агент, а выпускает человек после просмотра плана на странице подтверждения
- К одному серверу подключаются несколько сотрудников со своими токенами VK
- Подходящий метод VK API ищут по описанию на русском
- Агент читает стену, фотографии и диалоги в пределах разрешений токена
Не подходит, если
- Быстрый запуск на ноутбуке не получится: проект рассчитан на VPS с Keycloak и HTTPS
- Предполагаются произвольные HTTP-запросы или выполнение кода: их в первой версии нет
- Задача связана с VK Ads: отдельный современный API рекламы не заявлен
- Нужна готовая к продакшену система, хотя реальные токены в приложениях автор еще не проверил
Пример запроса к агенту
Сравни мое сообщество с двумя конкурентами за октябрь: частота постов, реакции, медианы и ER по просмотрам.MCP
- Транспорт
- http
- Авторизация
- OAuth
Ограничения
Автор называет проект прототипом: HTTPS, вход через Keycloak, MCP по Streamable HTTP и отказ без авторизации проверены, а реальные VK-токены и OAuth в конкретных приложениях еще нет. Самостоятельная регистрация закрыта до подготовки публичного сервиса.
Наличие метода в каталоге не значит доступность для конкретного токена: у VK ID для входа, пользовательского токена, токена сообщества и сервисного ключа разные права. Загрузки двоичных файлов и скачивания медиа по URL нет. Для запуска нужны параметры Keycloak и шифрования, режима без авторизации нет. Проект не официальный продукт VK.
Как отключить. Остановите службу на VPS и отзовите токены VK в настройках приложения ВКонтакте, затем удалите сервер из настроек клиента.
Частые вопросы
Как агент публикует записи в сообщество?
Он готовит план с неизменяемыми параметрами. Выполнится он только после входа человека на страницу подтверждения: инструмента для самостоятельного подтверждения у модели нет.
Где подробнее про подключение клиентов?
В `docs/CLIENTS.md` описаны подключение клиентов и границы совместимости, в `docs/DEPLOYMENT.md` развертывание с Keycloak и HTTPS.
Можно ли запустить сервер без Keycloak?
Нет. Для запуска нужны параметры Keycloak и шифрования, режима без авторизации в проекте нет.
Работает ли поиск по стенам любых пользователей?
Только в пределах разрешений выданного токена. Проверку настоящих прав автор советует выполнять на реальном аккаунте отдельно.
Что сравнение сообществ считает?
Частоту постов, реакции, медианы, ER по просмотрам и по числу участников, а также распределение форматов и времени публикаций с формулами и ограничениями.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыMCP-сервер для API ВКонтакте: профили, стены, сообщества, фото, лайки и статистика, публикация постов с подтверждением
vk-mcp (alexfisenkov)
vk-mcp
Удаленный MCP-сервер для сообществ ВКонтакте: 50 инструментов, посты, комментарии, диалоги, фото, видео и товары, запись выключена по умолчанию
Полный MCP для VK API
full-vk-mcp
MCP-сервер, автогенерируемый из схемы VK API: больше 180 инструментов с фильтрами по режиму чтение, запись, деньги и по разделам API
VK MCP Server (ORAMAN)
VK-MCP-Server
Локальный MCP-сервер для VK API: поиск людей и городов, профили, фото и видео с HTML-галереей, пул токенов и кэш SQLite
MCP-сервер ВКонтакте для Make
MCP VKontakte Server
MCP-сервер ВКонтакте на 42 инструмента для Make MCP Client: посты, истории, фотоальбомы, модерация групп и вебхуки
MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-vkontakte (ailenreiko1977-tech) (эта карточка) | нет | OAuth | 0 | |
| MCP для публикации и стены ВКонтакте | нет | API-ключ | 1 | другой сервер ВКонтакте без подтверждения записи на отдельной странице |
| MCP для управления сообществом VK | нет | API-ключ | 0 | сервер сообществ без сравнения сообществ по метрикам |
Коротко о README
В README указан статус прототипа, список возможностей, перечень того, чего в первой версии нет намеренно, ссылки на документы по архитектуре, развертыванию и проверке, а также команды для локальных тестов.