vk-mcp-ru

vk-mcp-ru

VK API para asistentes de IA: productos de la tienda de la comunidad, publicaciones, campañas publicitarias y estadísticas, diálogos con clientes, formularios de leads. Catálogo basado en el esquema oficial, cada método tiene una clase de acceso.

El catálogo se recopila de la fuente original (esquema oficial VKCOM/vk-api-schema) y se encuentra en el repositorio como vk_mcp/endpoints.yaml: 373 métodos, de los cuales 159 de lectura, 173 de escritura y 41 irreversibles. El servidor ejecuta exactamente este archivo, por lo que la tabla siguiente no puede diferir del código.

Instalación

uvx vk-mcp-ru

Claude Desktop, claude_desktop_config.json:

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

Claves

dev.vk.com → aplicación → clave de acceso de servicio, o token de comunidad con permisos market, messages, ads, stats. Solicite solo los permisos que realmente necesite.

variable	secreto	qué es
VK_TOKEN	sí	Clave de servicio de la aplicación VK o token de comunidad con los permisos necesarios.

Las claves no tienen que estar en el entorno: el servidor admite cuentas y las guarda en ~/.ru-mcp/cabinets.json con permisos 600, fuera del repositorio.

Mapa de métodos

sección	métodos	lectura	escritura	irreversible
Comunidades	51	20	25	6
Diálogos	48	21	22	5
Publicidad	47	24	16	7
Productos y tienda	45	16	23	6
Fotografías	44	18	22	4
Vídeo	34	9	20	5
Publicaciones en el muro	25	7	16	2
Discusiones	13	2	9	2
Documentos	12	7	4	1
Páginas wiki	8	4	4	0
Formularios de leads	7	3	3	1
Pedidos	7	5	2	0
Utilidades	7	6	0	1
Tarjetas en publicaciones	6	3	2	1
Usuarios	5	4	1	0
VK Donut	4	4	0	0
Estadísticas	3	2	1	0
Almacenamiento de la aplicación	3	2	1	0
Notificaciones	3	1	2	0
Podcasts	1	1	0	0
total	373	159	173	41

Cómo se ve en el chat

Usted: publicaciones en el muro de la comunidad

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": "..."})

Tres herramientas en lugar de 373 funciones: el agente busca el método por palabras, lee su tarjeta y lo llama. Las operaciones de escritura e irreversibles piden confirmación.

Lo que suele pedirse:

• Consolidar pedidos y productos de la tienda de la comunidad en una tabla.
• Ver estadísticas de la comunidad y de las publicaciones por período.
• Recopilar gastos y métricas de campañas publicitarias de VK Ads.
• Revisar diálogos no leídos y preparar respuestas para aprobación.

Seguridad

El servidor funciona en la máquina del usuario, las claves no salen al exterior. Los métodos tienen tres clases de acceso: la lectura se ejecuta de inmediato, la escritura y las acciones irreversibles requieren confirmación. El encabezado de autorización no sale de los dominios del servicio incluso al llamar a una ruta arbitraria.

Verificar la instalación

uvx vk-mcp-ru doctor

Imprime cuántos métodos se cargaron, si se encontraron las claves y de dónde. No muestra secretos. Con --live realiza una llamada real de lectura de bajo costo.

Relacionados

El núcleo está extraído en schema-mcp-core. Servidores vecinos: hh-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Los marketplaces viven por separado: marketplaces-mcp-ru.

MIT. Autor Ilya Utov.

Todos los proyectos en una lista, clasificados por propósito: ilyautov.github.io.