vk-mcp (alexfisenkov)

Установка

Работает в

• Claude Code
• Claude Desktop
• SourceCraft
• Koda
• Coddy

Сервисы

• ВКонтакте

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

Что делает

Сервер по Streamable HTTP работает на Linux с systemd, агент подключается по HTTPS без локального процесса. Версия 0.3 содержит 50 инструментов и 102 действия: 100 методов VK API и два сценария загрузки медиа. Покрыты посты, комментарии, диалоги, статистика, фото, видео и товары сообщества, модерация, опросы, истории и документы. Сообщества задаются явным списком допустимых. Ключи сообщества, пользователя и службы лежат на сервере, каталог сам выбирает подходящий тип, а клиент не передает ключ в аргументах инструмента. Запись выключена по умолчанию: план живет 10 минут, а для выполнения нужны включенный профиль записи и независимое подтверждение точного хэша через `deploy/approve.py` от root. Создать это подтверждение MCP-клиент не может. Медиа загружаются по публичному HTTPS-адресу с проверкой редиректов и размера, до 20 МиБ, форматы JPEG, PNG, WebP и MP4. Установку агенту и оператору описывает `docs/onboarding.md`.

Для кого. Администраторам и SMM-командам сообществ ВКонтакте, у которых есть Linux-сервер и которым нужен агент для постов и модерации с жесткой защитой записи.

Пример запроса к агенту

Покажи комментарии под тремя последними постами сообщества и предложи ответы на вопросы о доставке, ничего не публикуй.

MCP

Транспорт

http

Авторизация

API-ключ

Ограничения

Покрытие каталога не гарантирует доступ с любым токеном: права проверяются отдельно для каждого метода и сообщества. Бессрочных ограничений два: HTTP принимает до 1 МиБ на запрос и 120 авторизованных запросов в минуту, ответ VK берется до 4 МиБ с интервалом вызовов 350 мс.

Планы записи хранятся с исходной нагрузкой в каталоге службы с правами 0700, автоматической очистки пока нет. Core работает с server bearer, а OAuth требует отдельного прокси. Для локальной разработки хватает Node.js 22 и `npm run check`, но `npm start` без защищенных файлов конфигурации не запустится.

Как отключить. Остановите службу и отзовите ключи сообщества в настройках VK, затем удалите сервер из клиента MCP.

Коротко о README

В README версия 0.3, ссылки на документы по установке, ошибкам, восстановлению, профилям записи и обновлению токенов, команды для разработки, а также раздел о безопасности с лимитами и порядком выпуска.