VK API MCP (RU) — товары, сообщества, реклама

Name: VK API MCP (RU) — товары, сообщества, реклама
Author: ilyautov

本地服务

business-mcp-ru.aifrontier.tech社交媒体33 周前更新

代码仓库访问官网

关于 VK API MCP (RU) — товары, сообщества, реклама

面向 AI 助手的 VK API MCP 服务，覆盖社区商店、帖子、广告、客户对话和线索表单。方法目录基于官方 VK API schema，并按访问类型分类。

主要功能

01管理社区商品与订单
02发布和查询墙帖
03管理广告并查看统计
04处理客户对话
05管理线索表单
06按访问类型区分方法

适用场景

01汇总社区商店订单与商品
02查看社区和帖子统计
03整理 VK Ads 广告支出与指标
04筛选未读对话并拟定待审回复

MCP 相关

向 MCP 客户端提供 VK API 工具，客户端可搜索方法、查看详情并调用。写入和不可逆操作需要确认。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令uvx vk-mcp-ru

需要配置的环境变量

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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypivk-mcp-ru0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

vk-mcp-ru

面向 AI 助手的 VK API：社区商店商品、帖子、广告活动和统计数据、客户对话、潜在客户表单。目录来自官方架构，每个方法都标注了访问类别。

目录根据原始来源（官方架构 VKCOM/vk-api-schema）生成，并保存在仓库中的 vk_mcp/endpoints.yaml：373 个方法，其中 159 个用于读取， 173 个用于写入，41 个不可逆。服务严格按照此文件执行，因此下表与代码始终一致。

安装

有两种方式，请根据是否有终端选择。

无需终端：.mcpb 文件

从发布页面下载 vk-mcp-ru-vX.Y.Z.mcpb，然后双击打开。Claude Desktop 会自动安装服务，并在单独的窗口中询问密钥，无需修改配置。需要 Python 3.10 或更高版本：服务会在首次启动时自行安装依赖项。

在终端中

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. Соседние серверы: diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

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

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Privacy Policy

vk-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в ~/.ru-mcp/cabinets.json, запросы идут только в API VK, телеметрии нет. Полный текст: PRIVACY_POLICY.md.

支持 Markdown

登录后评论