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. |
Capabilities
Features and capabilities supported by this server
| 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 | |
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/oines/astral-im-bridge'
If you have feedback or need assistance with the MCP directory API, please join our Discord server