Skip to main content
Glama
ilyautov

vk-mcp-ru

by ilyautov
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Remote

vk-mcp-ru

VK API для ИИ-ассистентов: товары магазина сообщества, посты, рекламные кампании и статистика, диалоги с клиентами, лид-формы. Каталог из официальной схемы, у каждого метода класс доступа.

PyPI CI License: MIT Методов Сайт Звёзды

Install in VS Code Install in Cursor

Каталог собран из первоисточника (официальная схема VKCOM/vk-api-schema) и лежит в репозитории как vk_mcp/endpoints.yaml: 373 метода, из них 159 на чтение, 173 на запись и 41 необратимых. Сервер исполняет ровно этот файл, поэтому таблица ниже не может разойтись с кодом.

Установка

uvx vk-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "vk-mcp": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": { "VK_TOKEN": "..." }
    }
  }
}

Ключи

dev.vk.com → приложение → сервисный ключ доступа, либо токен сообщества с правами market, messages, ads, stats. Запрашивайте только те права, которые реально нужны.

переменная

секрет

что это

VK_TOKEN

да

Сервисный ключ приложения VK или токен сообщества с нужными правами.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.ru-mcp/cabinets.json с правами 600, вне репозитория.

Карта методов

раздел

методов

чтение

запись

необратимое

Сообщества

51

20

25

6

Диалоги

48

21

22

5

Реклама

47

24

16

7

Товары и магазин

45

16

23

6

Фотографии

44

18

22

4

Видео

34

9

20

5

Записи на стене

25

7

16

2

Обсуждения

13

2

9

2

Документы

12

7

4

1

Вики-страницы

8

4

4

0

Лид-формы

7

3

3

1

Заказы

7

5

2

0

Утилиты

7

6

0

1

Карточки в записях

6

3

2

1

Пользователи

5

4

1

0

VK Donut

4

4

0

0

Статистика

3

2

1

0

Хранилище приложения

3

2

1

0

Уведомления

3

1

2

0

Подкасты

1

1

0

0

всего

373

159

173

41

Как это выглядит в чате

Вы: посты на стене сообщества

vk_search_methods("посты на стене сообщества")
  vk_wall_get        POST /method/wall.get      чтение
  vk_wall_search     POST /method/wall.search   чтение
  vk_wall_get_by_id  POST /method/wall.getById  чтение

vk_describe_method("vk_wall_get")
  Returns a list of posts on a user wall or community wall.
  POST api.vk.com/method/wall.get
  параметры: domain, offset, count, filter, extended, fields
  класс доступа: чтение

vk_call_method("vk_wall_get", {"domain": "...", "offset": "..."})

Три инструмента вместо 373 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.

Что обычно просят:

  • Свести заказы и товары магазина сообщества в таблицу.

  • Посмотреть статистику сообщества и постов за период.

  • Собрать расходы и показатели рекламных кампаний VK Ads.

  • Разобрать непрочитанные диалоги и подготовить ответы на согласование.

Безопасность

Сервер работает на машине пользователя, ключи наружу не уходят. У методов три класса доступа: чтение идёт сразу, запись и необратимые действия требуют подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове произвольного пути.

Проверить установку

uvx vk-mcp-ru doctor

Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не показывает. С --live делает один дешёвый реальный вызов на чтение.

Родня

Ядро вынесено в schema-mcp-core. Соседние серверы: hh-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

MIT. Автор Илья Утов.