VK MCP Server (ORAMAN)
VK-MCP-Server
Локальный MCP-сервер для VK API: поиск людей и городов, профили, фото и видео с HTML-галереей, пул токенов и кэш SQLite
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токены VK открывают персональные данные: профили, фотографии, видео и список друзей
- Инструменты поиска и сбора сведений о людях годятся для слежки, поэтому нужны согласие владельцев и список разрешенных идентификаторов
Установка
- Работает в
- Сервисы
Ручная установка
Установи сервер по `docs/INSTALLATION.md`, токен VK возьми из файла `vk_token.txt`, не печатая его. Для медиа-инструментов заполняй `VK_CONTENT_ALLOWED_IDS` только идентификаторами, на которые есть согласие владельцев.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токены VK открывают персональные данные: профили, фотографии, видео и список друзей
- Инструменты поиска и сбора сведений о людях годятся для слежки, поэтому нужны согласие владельцев и список разрешенных идентификаторов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Python 3.11 запускается локально и отдает MCP по Streamable HTTP на `http://127.0.0.1:4257/mcp`, а HTML-галерею на порту 4258. Инструменты поиска `vk_search_users`, `vk_search_cities` и `vk_search_people` сохраняют исходный запрос в `raw_query` и показывают, какие фильтры применены, а какие нет. Профиль, образование и карьера читаются отдельными инструментами. Медиа-инструменты получают фотографии, альбомы, видео и записи со стены с пагинацией, проверяют владельца каждого снимка и убирают повторы. Результат собирается в адаптивную галерею с вкладками «Все», «Фотографии», «Видео» и «Публикации». Токены берутся из локального `vk_token.txt` с ротацией, ответы кэшируются в SQLite с TTL 900 секунд, ведется журнал обращений. К контентным запросам применяется список разрешенных идентификаторов `VK_CONTENT_ALLOWED_IDS`, а статистика городов друзей включается отдельным списком `VK_FRIENDS_STATS_ALLOWED_IDS`. В комплекте есть системная инструкция для модели Gemma в Ollama и Page Assist.
Для кого. Исследователям и администраторам, которые работают с собственными аккаунтами ВКонтакте или с согласия владельцев и запускают локальные модели вроде Gemma.
Подходит, если
- Фотографии и видео своего аккаунта собираются в одну галерею для просмотра
- Поиск человека по имени идет с разбором того, какие фильтры VK применил
- Локальная модель в Ollama подключается к VK без выхода сервера в интернет
- Повторные запросы кэшируются, чтобы не упираться в лимиты VK API
Не подходит, если
- Сбор данных о чужих людях без их согласия или законного основания
- Серверу надо открыть порт во внешнюю сеть: без отдельной защиты и TLS автор этого не рекомендует
- Требуется надежная лицензия: файл лицензии в репозитории намеренно отсутствует
Пример запроса к агенту
Найди в VK человека по имени Иван Петров из Казани и покажи основной профиль, образование и карьеру.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
VK_TOKEN_FILE- Путь к файлу с токенами VK, по умолчанию `vk_token.txt`.
VK_CONTENT_ALLOWED_IDS- Список идентификаторов, для которых разрешены медиа-инструменты.
VK_FRIENDS_STATS_ALLOWED_IDS- Список идентификаторов для статистики городов друзей.
Ограничения
Установка описана для Windows: Python 3.11 или новее, виртуальное окружение, `pip install -r requirements.txt`, `.env` и файл `vk_token.txt`. Сервер не публикует порты наружу по умолчанию, и открывать их без аутентификации и TLS нельзя.
Медиа и статистика друзей работают только для аккаунтов из списков разрешенных, остальные запросы отклоняются. Реальный доступ к VK зависит от действующих токенов и настроек VK API, а успешная установка пакетов его не подтверждает. Лицензия не определена владельцем, обновление через GitHub выполняет `update.bat` и при `git reset --hard` стирает локальные правки.
Как отключить. Остановите процесс `vk_mcp_server.py`, удалите `vk_token.txt` и отзовите токен в настройках VK, затем уберите сервер из клиента.
Частые вопросы
Как запустить VK MCP Server?
Создайте окружение, выполните `pip install -r requirements.txt`, положите `vk_token.txt` рядом с `vk_mcp_server.py` и запустите `python vk_mcp_server.py`. Клиенту укажите Streamable HTTP и `http://127.0.0.1:4257/mcp`.
Для каких аккаунтов работают медиа-инструменты?
Только для идентификаторов из `VK_CONTENT_ALLOWED_IDS`. Автор советует вписывать туда собственные аккаунты или те, на обработку которых есть согласие владельца.
Как проверить токены и кэш?
Инструменты `vk_token_status` и `vk_cache_status` показывают состояние пула токенов без раскрытия значений и состояние кэша. Кэш чистит `vk_cache_clear`.
Нужна ли модель Gemma?
Нет. Сервер работает с любым клиентом MCP по Streamable HTTP. Инструкция `GEMMA_SYSTEM_PROMPT.md` нужна, если вы подключаете Gemma в Ollama или Page Assist.
Что делает update.bat?
Скрипт обновляет склонированный репозиторий: показывает изменения, затем дает выбор: fast-forward, перезапись из удаленной ветки или отмену. Перезапись стирает локальные правки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыПолный MCP для VK API
full-vk-mcp
MCP-сервер, автогенерируемый из схемы VK API: больше 180 инструментов с фильтрами по режиму чтение, запись, деньги и по разделам API
mcp-vkontakte (ailenreiko1977-tech)
mcp-vkontakte
MCP для ВКонтакте на собственном сервере: каталог методов VK API, чтение стен и сообществ, сравнение сообществ и запись только после подтверждения человека
MCP-сервер для API ВКонтакте: профили, стены, сообщества, фото, лайки и статистика, публикация постов с подтверждением
vk-mcp (alexfisenkov)
vk-mcp
Удаленный MCP-сервер для сообществ ВКонтакте: 50 инструментов, посты, комментарии, диалоги, фото, видео и товары, запись выключена по умолчанию
MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи
MCP-сервер для стены ВКонтакте: чтение и публикация постов, сообщения, друзья, сообщества и статистика группы, 8 инструментов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| VK MCP Server (ORAMAN) (эта карточка) | нет | API-ключ | 0 | |
| VK MCP Server | нет | API-ключ | 16 | другой сервер VK API без галереи и пула токенов с кэшем |
| vk-mcp-ru | нет | API-ключ | 3 | сервер VK без локальной HTML-галереи медиа |
Коротко о README
README перечисляет возможности и состав поставки, быструю установку на Windows, настройку Gemma, параметры `.env`, группы инструментов, обновление через GitHub, диагностику и правила безопасности.