Xadeus-QQ-MCP
Built by a 15-year-old developer, based on Amadeus-QQ-MCP.
QQ MCP (Model Context Protocol) Server — connects to QQ via NapCatQQ (OneBot v11), giving AI agents direct control over QQ (send/receive messages, group management, auto-wake on incoming messages, and more).
Features
| Feature | Description |
|---|---|
| Auto-Wake | Incoming QQ messages matching rules trigger the AI agent window automatically. Cross-platform — Windows (keybd_event), macOS (osascript+pbcopy), Linux (xdotool+xclip). Supports any client — opencode, Cursor, Claude Desktop, Windsurf — configure via set_wake_config |
| Dedup Lock | Prevents duplicate wake during processing. Unlock manually when done |
| Persistent Rules | Wake rules saved to wake_rules.json, auto-loaded on restart |
wait_for_reply Built-in |
send_message waits for reply by default |
| Group Moderation | Mute, unmute, kick, set card, send notices |
| File Sending | Send any file from URL to QQ groups/private chats |
| Message Recall | Recall bot-sent messages |
| Timer Scheduler | Cron or interval-based timed wake |
| One-Click Setup | Auto-detect NapCat, configure ports, update agent configs |
