@theyahia/vk-mcp

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

Часть серии Russian API MCP (50 серверов) 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 секунд

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

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

Лицензия

MIT