npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

vk-mcp-server

v0.9.0

Published

Model Context Protocol server for VK (VKontakte) social network API

Readme

VK MCP Server — ВКонтакте для Claude и других AI-ассистентов

English · Русский · Сайт проекта

MCP-сервер, через который Claude, Cursor, VS Code и другие клиенты Model Context Protocol работают с ВКонтакте: читают стены и сообщества, публикуют посты и истории, разбирают сообщения сообщества и отвечают на них. Открытый код, MIT, без своих серверов — всё работает у вас на компьютере с вашим токеном.

Что можно делать

  • Разбирать входящие сообщества. «Покажи непрочитанное и предложи ответы» — ассистент перечислит диалоги, перескажет каждый, набросает ответы, а отправит только те, что вы одобрили
  • Публиковать от имени сообщества — посты, комментарии, истории (фото и видео)
  • Читать стены, профили, информацию о сообществах и их участниках — с постраничной навигацией, которая сама объясняет, где продолжить
  • Видеть, а не читать JSON: в клиентах с поддержкой MCP Apps (Claude, Claude Desktop, VS Code Copilot, Goose) стены, сообщества и профили показываются карточками
  • Готовые сценарии (промпты): дайджест сообщества, отчёт по вовлечённости, портрет аудитории, поиск сообществ, разбор входящих

25 инструментов; запись помечена как запись, чтобы клиент спрашивал перед ней.

Быстрый старт

Claude Desktop — в один клик. Скачайте .mcpb со страницы релизов и откройте его: Claude Desktop установит сервер и попросит токены в форме. Node.js и конфиги не нужны.

Claude Code, Cursor и другие — добавьте в конфиг MCP (.mcp.json для Claude Code, claude_desktop_config.json для Claude Desktop):

{
  "mcpServers": {
    "vk": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "vk1.a...токен сообщества",
        "VK_SERVICE_KEY": "...сервисный ключ"
      }
    }
  }
}

Нужен Node.js 20 или новее.

Какие токены нужны

ВКонтакте сильно ограничил, что может каждый вид токена. Ниже — не документация VK, а то, что мы проверили на живом API в октябре 2026:

| Токен | Где взять | Что умеет | |---|---|---| | Токен сообщества | Сообщество → Управление → Работа с API → Ключи доступа → Создать ключ | От имени сообщества: посты, комментарии, истории, сообщения сообщества. Не читает стены, не редактирует и не удаляет посты, не загружает фото на стену | | Сервисный ключ | Настройки вашего приложения VK | Читает публичные профили, стены, сообщества. Ничего не пишет | | VK ID (vk2.a…) | npx vk-mcp-server --login <APP_ID> | Те же публичные чтения, что и сервисный ключ |

Лучший вариант — оба сразу. Токен сообщества в VK_ACCESS_TOKEN, сервисный ключ в VK_SERVICE_KEY. Сервер сначала пробует токен сообщества, а чтения, в которых VK ему отказывает (стена, например), сам повторяет сервисным ключом. Запись на ключ не уходит никогда.

Токен сообщества создаётся за три клика и не протухает. Отметьте права wall, photos, stories, messages и manage. Раздел «Работа с API» есть только в полной веб-версии — на телефоне включите «версию для компьютера».

Чего сейчас не может ни один токен, который VK выдаёт новым приложениям: редактировать и удалять посты, загружать фото на стену, читать статистику, лайки, фотоальбомы, поиск и ленту новостей. VK оставил это полным пользовательским токенам, а их новым приложениям больше не выдаёт. Инструменты для этого в сервере есть — они работают, если такой токен у вас остался.

Проверить, что умеет ваш токен:

VK_ACCESS_TOKEN=... VK_SERVICE_KEY=... npx vk-mcp-server --check

Модели сервер показывает только те инструменты, до которых ваш токен дотягивается: при старте спрашивает у VK, какой это токен, и убирает то, в чём VK ему откажет. Инструмент vk_token_info скажет, какой токен подключён, и для каждого убранного инструмента — что нужно, чтобы он заработал. Без токена или если VK не ответил, показываются все инструменты.

Подробно, по шагам и с разбором ошибок — в docs/SETUP.md (на английском).

Сообщения сообщества

| Инструмент | Что делает | |---|---| | vk_messages_get_conversations | Диалоги, новые сверху; filter: "unread" — то, что ждёт ответа | | vk_messages_get_history | Переписка в одном диалоге | | vk_messages_send | ✏️ Ответ от имени сообщества — уходит живому человеку, клиент спросит подтверждение | | vk_messages_mark_as_read | ✏️ Отметить диалог прочитанным |

Нужны право messages у токена и включённые сообщения в настройках сообщества. VK разрешает сообществу писать только тем, кто написал первым или разрешил сообщения от сообщества. Повтор запроса после лимита VK не доставит сообщение дважды.

Проще всего начать с промпта community_inbox: он пройдёт по непрочитанным, перескажет каждый диалог и подготовит черновики ответов.

События сообщества

Комментарии, лайки и стену VK токену сообщества не отдаёт, но присылает их событиями, если сообщество слушать. Достаточно один раз вызвать vk_events_listen: он включит Long Poll сообщества и нужные типы событий, если они выключены (версию API не трогает, если Long Poll уже читает другой бот), и начнёт получать события. Истории у VK нет: видно то, что происходит с этого момента, пока работает сервер.

| Инструмент | Что делает | |---|---| | vk_events_listen | ✏️ Начать получать новые комментарии (с текстом и id), лайки, посты и репосты, вступления и выходы, сообщения | | vk_events_get | Прочитать их по курсору; wait ждёт следующее до 25 с — агент может в цикле отвечать на каждый новый комментарий |

Удалять комментарии токен сообщества по-прежнему не может.

Все инструменты

Полный список с описаниями — в английском README: пользователи, стена, сообщества, фото, истории, сообщения, лайки, статистика.

Частые ошибки

| Что видите | Что это значит | |---|---| | error 27: Group authorization failed | Токену сообщества VK этот метод не даёт (чтение стены, например). Задайте VK_SERVICE_KEY — чтения пойдут через ключ | | error 1051 или error 28 | Метод закрыт для этого вида токена. Чтобы писать — нужен токен сообщества | | error 901 | Человек не писал сообществу и не разрешал сообщения от него | | error 5 | VK не принимает токен: его отозвали, удалили или заменили новым — или вставили с кавычками, пробелами или комментарием в конце. Проверьте, что вставлен весь токен и ничего больше; если да — создайте новый там, где брали (токен сообщества: Управление → Работа с API → Ключи доступа). --login выдаёт только токены VK ID, а они не постят | | error 5 с subcode 1130 | Токен привязан к IP, с которого его получили, а сервер работает с другого. Используйте токен сообщества — он не привязан | | No VK token configured | Клиент не передал токен серверу — проверьте блок env в конфиге клиента |

Ссылки

  • npm: vk-mcp-server
  • Официальный реестр MCP: io.github.bulatko/vk
  • Что нового: CHANGELOG.md
  • Нашли ошибку или нужен метод — issues, PR приветствуются

Лицензия MIT.