io.github.theYahia/vk-mcp

Official

by theYahia · TypeScript

MCP server for VK API — wall posts, news search, users, groups. 4 tools.

Access VK social network data including posts, news, users, and groups.

Topics

aiclaudellmmcpmcp-servermodel-context-protocolrussian-apitypescriptvkapisocial-media

README.md3 KBView on GitHub

@theyahia/vk-mcp

MCP-сервер для VK API — записи со стены, публикация, сообщения, друзья, пользователи, группы, статистика. 8 инструментов.

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop

json

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

Claude Code

bash

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

VS Code / Cursor

json

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

Smithery

bash

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 дней

Примеры

code

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

Разработка

bash

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 секунд

Часть серии Russian API MCP

50 серверов: github.com/theYahia/russian-mcp

Лицензия

MIT

Install

Configuration

Environment variables

VK_ACCESS_TOKENrequiredsecret

API key for the service

claude_desktop_config.json

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