Skip to main content
Glama
HUliangwei

qq-onebot-mcp

by HUliangwei
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
QQ_BOTYes机器人 QQ 号
LLM_MODELNo群聊直答用模型
LLM_API_KEYNo群聊直答用 API 密钥
LLM_BASE_URLNo群聊直答用基础 URL
ONEBOT_WS_URLNoNapCat WS 地址（默认 ws://127.0.0.1:3001）ws://127.0.0.1:3001
QQ_ALLOWED_GROUPSNo静态群白名单（留空=动态）
QQ_ALLOWED_SENDERSYes私聊白名单，逗号分隔

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
qq_sendA

Send a private message to the current chat user (the whitelisted owner from inbox). message is the content.

qq_poll_inboxA

Fetch private messages received by the bot (whitelisted owner only). Returns immediately if new messages; else waits up to timeoutMs (max 30000, batch max 50).

qq_wait_inboxA

BLOCK until new private messages arrive (zero polling/cost while waiting). Returns immediately when messages arrive; or after maxWaitMs. Call in a loop to idle efficiently waiting for QQ messages.

qq_statusA

Query bridge status: connection, bot QQ, private whitelist, group whitelist, inbox count.

qq_get_agent_profileA

Get the AGENTS.md role profile (personality, duties, security boundaries) that defines how this QQ bridge agent should behave. Load it once and treat it as your system prompt while chatting through QQ. Path overridable via AGENTS_MD env.

qq_take_disc_changeA

Check if the owner requested a DISC CHANGE (换碟) in private chat. Returns true once if a new-conversation signal is pending (connector should start a fresh session), false otherwise. Poll after handling inbox messages.

qq_attachA

Claims the QQ bridge for THIS conversation (exclusive). Pass a unique tag (e.g. your session id) to identify the owner. Fails if another conversation already claimed it. Call once when you start handling QQ.

qq_detachA

Releases the QQ bridge. Only the current owner (matching tag) can release; others get an error. Call when done or on /布卡换碟 new-conversation.

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/HUliangwei/qq-onebot-mcp'

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