vk-mcp

VK MCP — 在 VKontakte 发布内容并通过 AI 操作动态墙

如果你想了解如何直接在 AI 对话中发布内容到 VKontakte、阅读社区动态墙、处理私信，或无需手动导出数据即可查看群组统计数据，那么你找对了。基于 VK API 的 8 个工具：动态墙帖子、内容发布、消息、好友、用户、群组和统计数据。

这是 WWmcp 系列（46 个服务）的一部分，由 @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	获取社区统计数据

技能（提示词）

技能	描述
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 版本：v=5.199
• 身份验证：VK_ACCESS_TOKEN（环境变量）
• 重试：使用 exponential backoff 重试 3 次（429、5xx）
• 超时：10 秒

WWmcp 系列

46 个服务： github.com/theYahia/WWmcp

许可证

MIT

---

WWmcp 系列 · Telegram： @vhodvai