VK MCP Server

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

MCP-серверВысокий рискРоссийский стек

bulatko/vk-mcp-server

Установка

{
  "mcpServers": {
    "vk": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

Файл .mcp.json проекта. Тот же блок подходит для claude_desktop_config.json.

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

Что делает

Сервер дает агенту 19 инструментов для ВКонтакте: поиск и чтение профилей, записи со стен, информация о сообществах и их участниках, фотоальбомы, друзья, лента, лайки и статистика сообщества. Инструменты записи публикуют, редактируют и удаляют посты, оставляют комментарии, загружают фото и вступают в сообщества, они помечены аннотациями, чтобы клиент спрашивал подтверждение. Готовые промпты делают дайджест сообщества, отчет по вовлеченности, портрет аудитории и черновик поста в тоне сообщества. Команда --check определяет тип токена и проверяет, какие методы ему доступны, а в клиентах с поддержкой MCP Apps стены и профили показываются карточками.

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

Подходит, если

  • Нужно понять, какие посты сообщества собрали больше всего реакций
  • Нужно подготовить и опубликовать пост в своем сообществе
  • Нужно найти и сравнить сообщества по теме

Не подходит, если

  • Нужны личные сообщения или массовые рассылки
  • Нужна полная статистика и публикация, а есть только токен VK ID

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

Сделай отчет по вовлеченности за последние 30 постов нашего сообщества и объясни, что общего у самых удачных

Ограничения

Возможности зависят от типа токена. Токен VK ID из команды --login читает только публичные профили, стены и сообщества, публикация, фото, друзья, лента и статистика вернут ошибку 1051. Для записи нужен токен сообщества с правами wall и photos. Пользовательские токены VK ограничивает несколькими запросами в секунду и может привязать к IP.

Как отключить. Удалите блок vk из конфигурации MCP клиента или расширение в Claude Desktop и отзовите токен в настройках сообщества.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
VK_ACCESS_TOKEN
обязательная, секрет
Токен API ВКонтакте: сообщества, пользователя или сервисный
VK_TIMEOUT_MS
Таймаут запроса в миллисекундах, по умолчанию 30000
VK_API_BASE
Базовый адрес API, по умолчанию https://api.vk.com/method

Проверка безопасности

  • Публикует, редактирует и удаляет посты от имени сообщества или пользователя
  • Хранит бессрочный токен сообщества

Коротко о README

README описывает установку в один клик через .mcpb для Claude Desktop и кнопку для VS Code, запуск через npx и публикацию в официальном реестре MCP. Подробно разобраны три типа токенов VK и что каждый умеет, приведены конфигурации для Claude Desktop и Claude Code и переменные окружения. Есть таблица типичных ошибок VK с решениями, список инструментов с пометками записи и готовые промпты. Лицензия MIT.

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

Какой токен выбрать?

Для публикации нужен токен сообщества: Управление, Работа с API, Ключи доступа. Для чтения публичных данных хватит токена VK ID или сервисного ключа.

Что значит ошибка 5 с подкодом 1130?

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

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий риск

Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети

СкиллВысокий риск25,9 тыс.

Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском

СкиллНизкий риск17,3 тыс.