Skip to main content
Glama
JulesLiu390

Amadeus-QQ-MCP

by JulesLiu390
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
qqYes机器人 QQ 号 (Robot QQ number)
groupsNo监听的群号（逗号分隔） (List of group IDs to listen to, comma-separated)
friendsNo监听的好友 QQ（逗号分隔） (List of friend QQ numbers to listen to, comma-separated)
ws-portNoNapCat WebSocket 端口 (NapCat WebSocket port)3001
log-levelNo日志级别 (Log level)info
buffer-sizeNo每个目标的消息缓冲区大小 (Message buffer size per target)100
napcat-hostNoNapCat HTTP 地址 (NapCat HTTP address)127.0.0.1
napcat-portNoNapCat HTTP 端口 (NapCat HTTP port)3000

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
check_statusB

Check QQ login status and NapCat connection status.

get_group_listB

Get the list of QQ groups the bot has joined.

get_recent_contextA

Get recent message context for a monitored group or whitelisted friend.

Returns all buffered messages (backfill + real-time) without compression. Use compress_context to manually compress when needed. Images are returned as URL strings in each message's image_urls field.

Args: target: Group ID or friend QQ ID. target_type: "group" (default) or "private". limit: Number of recent messages to return (default 200).

batch_get_recent_contextA

Batch query recent message context for multiple targets.

More efficient than calling get_recent_context multiple times: uses at most 2 OneBot API calls (group list + friend list) regardless of how many targets are queried.

Args: targets: List of dicts, each with "target" (ID) and optional "target_type" ("group" or "private", default "group"). Example: [{"target": "123", "target_type": "group"}, {"target": "456", "target_type": "private"}] limit: Number of recent messages per target (default 50).

send_messageA

Send a message to a monitored group or whitelisted friend.

Args: target: Group ID or friend QQ ID. content: Text message content. target_type: "group" (default) or "private". reply_to: Optional message ID to reply to. split_content: Whether to split long messages into multiple chunks with typing delay (default True). Set to False to send as a single message without splitting. num_chunks: If set, split the message into exactly this many chunks using natural punctuation boundaries. Overrides split_content. The message is first split by punctuation, then the fine chunks are merged into exactly num_chunks groups (e.g. num_chunks=3 sends exactly 3 messages with typing delays between them).

send_imageB

Send an image to a monitored group or whitelisted friend.

Args: target: Group ID or friend QQ ID. image: Base64-encoded image data (without the base64:// prefix). target_type: "group" (default) or "private". reply_to: Optional message ID to reply to.

compress_contextB

Compress all buffered messages for a target into a summary.

This replaces raw messages with a compressed summary, freeing up the buffer. Use this after reading context when you want to archive old messages.

Args: target: Group ID or friend QQ ID. target_type: "group" (default) or "private".

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JulesLiu390/Amadeus-QQ-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server