vk-mcp

Name: vk-mcp
Author: theYahia

Local

github.com/theYahiaSocial Media1Updated 8w ago

Repository

About vk-mcp

vk-mcp is an MCP server for AI assistants that work with the VK API. It provides tools for wall posts, search, user and group details, messaging, and group statistics, over stdio or Streamable HTTP.

Key features

01Read and publish wall posts
02Search posts by keyword
03Retrieve user, group, and friend details
04Send messages and view group statistics

Use cases

01Check recent posts on a user or group wall
02Find VK posts about a topic
03Send a message to a VK user
04Review a group's statistics

MCP support

The server exposes eight VK API tools to MCP clients for posts, search, users, groups, friends, messaging, and statistics. It supports stdio and Streamable HTTP.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "theyahia-vk": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/vk-mcp"
      ],
      "env": {
        "VK_ACCESS_TOKEN": "<VK_ACCESS_TOKEN>"
      }
    }
  }
}

Run commandnpx -y @theyahia/vk-mcp

Environment variables to set

VK_ACCESS_TOKENSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@theyahia/vk-mcp1.0.1stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
count	integer	No	Number of records
offset	integer	No	Offset
owner_id	number	Yes	Wall owner's ID (user or group; negative for groups)

Details

From the project README

VK MCP — публикация во ВКонтакте и работа со стеной из нейросети

Если вы искали, как постить во ВКонтакте прямо из диалога с ИИ, читать стену сообщества, разбирать личные сообщения или снимать статистику группы без ручных выгрузок — это оно. 8 инструментов поверх VK API: записи со стены, публикация, сообщения, друзья, пользователи, группы и статистика.

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

{
  "mcpServers": {
    "vk": {
      "command": "npx",
      "args": ["-y", "@theyahia/vk-mcp"],
      "env": { "VK_ACCESS_TOKEN": "your-token" }
    }
  }
}

Claude Code

claude mcp add vk -e VK_ACCESS_TOKEN=your-token -- npx -y @theyahia/vk-mcp

VS Code / Cursor

{
  "servers": {
    "vk": {
      "command": "npx",
      "args": ["-y", "@theyahia/vk-mcp"],
      "env": { "VK_ACCESS_TOKEN": "your-token" }
    }
  }
}

Smithery

npx @smithery/cli install @theyahia/vk-mcp --client claude

Требуется VK_ACCESS_TOKEN. Получите на vk.com/dev.

Транспорт

Режим	Запуск
stdio (по умолчанию)	`npx @theyahia/vk-mcp`
Streamable HTTP	`npx @theyahia/vk-mcp --http` (порт 3000 или `PORT=8080`)

Инструменты (8)

Инструмент	Метод VK API	Описание
`get_wall`	`wall.get`	Записи со стены пользователя или сообщества
`post_wall`	`wall.post`	Публикация записи на стене
`search_posts`	`newsfeed.search`	Поиск постов по ключевым словам
`get_user`	`users.get`	Информация о пользователях
`get_groups`	`groups.getById`	Информация о сообществах
`get_friends`	`friends.get`	Список друзей пользователя
`send_message`	`messages.send`	Отправка сообщения
`get_stats`	`stats.get`	Статистика сообщества

Skills (Prompts)

Skill	Описание
`post-wall`	Опубликуй пост в группу VK
`group-stats`	Статистика группы VK за N дней

Примеры

Покажи последние посты со стены Дурова
Опубликуй пост "Привет мир!" в группу 123456
Найди посты про AI в VK
Информация о группе team
Покажи моих друзей
Статистика группы 123456 за 30 дней

Разработка

npm install
npm test          # Vitest
npm run build     # TypeScript
npm run dev       # tsx watch

API

Base URL: https://api.vk.com/method/
API version: v=5.199
Auth: VK_ACCESS_TOKEN (env)
Retry: 3 попытки с exponential backoff (429, 5xx)
Timeout: 10 секунд

Часть серии WWmcp

46 серверов: github.com/theYahia/WWmcp

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.