astral-bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ASTRAL_BRIDGE_BOT_QQ | Yes | Bot QQ user id. | |
| ASTRAL_BRIDGE_CONFIG | No | Path to the JSON config file. | |
| ASTRAL_BRIDGE_THREAD_ID | Yes | Fixed Astral thread/session id. | |
| ASTRAL_BRIDGE_MCP_TRANSPORT | No | stdio or http. | stdio |
| ASTRAL_BRIDGE_APP_SERVER_URL | No | Astral app-server WebSocket URL. | ws://127.0.0.1:4222 |
| ASTRAL_BRIDGE_ALLOWED_GROUP_IDS | Yes | Comma-separated allowed group ids. | |
| ASTRAL_BRIDGE_APP_SERVER_AUTH_TOKEN | No | Bearer token for Astral app-server. | |
| ASTRAL_BRIDGE_ALLOWED_PRIVATE_USER_IDS | Yes | Comma-separated allowed private user ids. |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| qq_get_recent_messagesC | Get recent stored QQ messages for a group or private conversation. |
| qq_get_messageC | Get one stored QQ message by OneBot message_id. |
| qq_get_unread_messagesB | Get the current unread batch for a group or private conversation. This returns the messages counted by the latest conversation_unread prompt. |
| qq_search_messagesB | Search stored QQ text messages in a group or private conversation. |
| qq_get_conversation_stateC | Get bridge state for a QQ conversation. |
| qq_download_mediaC | Download a stored QQ image/file attachment to the local media cache and return its path. |
| qq_send_group_messageB | Send a QQ group message. Supports exact ordered parts for mixed text, @mentions, and images. |
| qq_send_private_messageB | Send a QQ private message. Supports exact ordered text/image parts and replying to a message id. |
| qq_send_group_fileC | Upload a local file or URL to a QQ group using NapCat's OneBot-compatible file action. |
| qq_send_private_fileB | Upload a local file or URL to a QQ private chat using NapCat's OneBot-compatible file action. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool targets a distinct operation: download media, retrieve various message types, send messages/files to group/private, and check conversation state. No ambiguity between tools.
All tools follow a consistent `qq_verb_noun` snake_case pattern, using clear verbs like download, get, send, search and specific objects like media, message, group_file, private_message.
10 tools is well-scoped for a messaging bridge, covering message retrieval, sending, file uploads, and state queries without superfluous or missing functionality.
Core message lifecycle is covered: read, search, send (text/files) for both group and private. Minor gaps like deleting messages or listing conversations exist but are acceptable for a bridge focused on message relay.