mouse114514/Xadeus-QQ-MCP

Overview

A Python-based MCP server for QQ, forked from Amadeus-QQ-MCP. It supports automatic wake-up, message sending and receiving, and group chat management. Provides one-click configuration for Windows deployment.

Best for

Best for
Developers needing a quick QQ MCP server setup on Windows for AI agent integration

Use cases

• Connect AI agents to QQ for automated messaging
• Manage group chat interactions programmatically
• Deploy a QQ bot with minimal setup on Windows

How to use

Install

uv run python -m qq_agent_mcp --qq YOUR_QQ

Tools exposed

• send_message
• send_image
• send_voice
• wait_for_reply
• get_recent_context
• batch_get_recent_context
• screenshot_chat
• compress_context
• add_wake_rule
• remove_wake_rule
• list_wake_rules
• set_wake_pending
• set_wake_enabled
• set_wake_config
• get_wake_config
• diagnose_wake
• get_group_list
• get_group_member_list
• get_group_member_info
• mute_member

Tested with

Cursor, Claude Desktop, opencode, Windsurf

Example client config

[object Object]

Notes

A Python-based MCP server for QQ, forked from Amadeus-QQ-MCP. It supports automatic wake-up, message sending and receiving, and group chat management. Provides one-click configuration for Windows deployment.

0 stars on GitHub. Last updated 2026-06-09. Licensed MIT.

Use cases

• Connect AI agents to QQ for automated messaging
• Manage group chat interactions programmatically
• Deploy a QQ bot with minimal setup on Windows

Pros

• Supports auto-wake functionality for persistent connections
• Includes group management features
• One-click configuration simplifies Windows setup

Cons

• Zero stars on GitHub suggests very limited adoption or testing
• Only supports Windows for one-click configuration
• May rely on reverse-engineered QQ protocols with potential instability

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.