English Français العربية

io.github.theYahia/vk-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/vk-mcp
Claude Code 
claude mcp add vk-mcp -e 'VK_ACCESS_TOKEN=<your vk_access_token>' -- npx -y @theyahia/vk-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vk-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/vk-mcp@1.0.1"
            ],
            "env": {
                "VK_ACCESS_TOKEN": "<your vk_access_token>"
            }
        }
    }
}

متغيرات البيئة

  • VK_ACCESS_TOKEN إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. VK MCP — публикация во ВКонтакте и работа со стеной из нейросети
  2. Установка
  3. Транспорт
  4. Инструменты (8)
  5. Skills (Prompts)
  6. Примеры
  7. Разработка
  8. API
  9. Часть серии WWmcp
  10. Лицензия

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 HTTPnpx @theyahia/vk-mcp --http (порт 3000 или PORT=8080)

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

ИнструментМетод VK APIОписание
get_wallwall.getЗаписи со стены пользователя или сообщества
post_wallwall.postПубликация записи на стене
search_postsnewsfeed.searchПоиск постов по ключевым словам
get_userusers.getИнформация о пользователях
get_groupsgroups.getByIdИнформация о сообществах
get_friendsfriends.getСписок друзей пользователя
send_messagemessages.sendОтправка сообщения
get_statsstats.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

الأسئلة الشائعة

ما هو io.github.theYahia/vk-mcp؟

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

كيف أثبّت io.github.theYahia/vk-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add vk-mcp -e 'VK_ACCESS_TOKEN=<your vk_access_token>' -- npx -y @theyahia/vk-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/vk-mcp إلى مفتاح API؟

نعم. يتطلب VK_ACCESS_TOKEN، وتضبطها في إعداداته.

هل io.github.theYahia/vk-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/vk-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.