io.github.bulatko/vk
MCP server for VK (VKontakte) API: users, walls, groups, friends, newsfeed, photos.
Ask AI about io.github.bulatko/vk
Powered by Claude · Grounded in docs
I know everything about io.github.bulatko/vk. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
VK MCP Server
Model Context Protocol (MCP) server for VK (VKontakte) social network API
Enables AI assistants like Claude to interact with VK through a standardized interface.
Features
- Read Operations: Get users, wall posts, groups, friends, newsfeed, photos
- Write Operations: Create posts, add comments
- Analytics: Get community statistics
- Secure: Token-based authentication via environment variable
- Tested: Comprehensive test coverage
- Easy Install: Available on npm and MCP Registry
Quick Start
Installation
npm install -g vk-mcp-server
Or run directly with npx:
npx vk-mcp-server
MCP Registry
Also available in the official MCP Registry:
io.github.bulatko/vk
Getting VK Access Token
- Go to VK Developers and create a Standalone app
- Get your app ID
- Open this URL (replace
YOUR_APP_ID):https://oauth.vk.com/authorize?client_id=YOUR_APP_ID&display=page&redirect_uri=https://oauth.vk.com/blank.html&scope=friends,wall,groups,photos,stats,offline&response_type=token&v=5.199 - Authorize and copy the
access_tokenfrom the URL
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"vk": {
"command": "npx",
"args": ["-y", "vk-mcp-server"],
"env": {
"VK_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}
Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"vk": {
"command": "npx",
"args": ["-y", "vk-mcp-server"],
"env": {
"VK_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
vk_users_get | Get user profiles by IDs or screen names |
vk_wall_get | Get posts from user/community wall |
vk_wall_post | Publish a new post |
vk_wall_create_comment | Add comment to a post |
vk_groups_get | Get user's communities list |
vk_groups_get_by_id | Get community info by ID |
vk_friends_get | Get user's friends list |
vk_newsfeed_get | Get user's newsfeed |
vk_stats_get | Get community statistics (admin only) |
vk_photos_get | Get photos from albums |
Usage Examples
Once configured, you can ask Claude:
- "Get information about Pavel Durov's VK profile"
- "Show me the latest 5 posts from the VK official community"
- "Post 'Hello World!' on my wall"
- "Get the list of communities I'm a member of"
- "Show my newsfeed"
Example Conversation
User: What's on Pavel Durov's wall?
Claude: I'll check Pavel Durov's VK wall for recent posts.
[Uses vk_wall_get with domain="durov"]
Here are the latest posts from Pavel Durov's wall:
1. [Post content...]
2. [Post content...]
Testing
Run the test suite:
npm test
Run tests with coverage:
npm run test:coverage
API Reference
This server wraps VK API v5.199. For detailed parameter documentation, see:
Security Notes
- Never share your access token
- The
offlinescope provides a non-expiring token - Review permissions before authorizing
- For production, consider using a service token
Contributing
Contributions are welcome! Please read the Contributing Guidelines first.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
MIT © 2026 bulatko
Links
Made with ❤️ for the MCP ecosystem
