io.github.theYahia/vk-mcp
MCP server for VK API — wall posts, news search, users, groups. 4 tools.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@theyahia/vk-mcpclaude mcp add vk-mcp -e 'VK_ACCESS_TOKEN=<your vk_access_token>' -- npx -y @theyahia/vk-mcp@1.0.1
{
"mcpServers": {
"vk-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/vk-mcp@1.0.1"
],
"env": {
"VK_ACCESS_TOKEN": "<your vk_access_token>"
}
}
}
}
Variables d'environnement
VK_ACCESS_TOKENobligatoire secret API key for the service
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que io.github.theYahia/vk-mcp ?
MCP server for VK API — wall posts, news search, users, groups. 4 tools.
Comment installer io.github.theYahia/vk-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add vk-mcp -e 'VK_ACCESS_TOKEN=<your vk_access_token>' -- npx -y @theyahia/vk-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.theYahia/vk-mcp ?
Oui. Il attend VK_ACCESS_TOKEN, à renseigner dans sa configuration.
io.github.theYahia/vk-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.theYahia/vk-mcp ?
Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.