onebot11-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ONEBOT_WS_URL | No | Forward WebSocket URL; set to 'none' to disable this channel. | ws://127.0.0.1:3001 |
| ONEBOT_HTTP_URL | No | HTTP adapter URL; set to 'none' to disable this channel. | http://127.0.0.1:3000 |
| ONEBOT_READONLY | No | Set to '1' to register only query tools; write operations will not appear in tools/list. | |
| ONEBOT_TRANSPORT | No | Transport selection: 'auto' (HTTP first, fallback to WS), 'http', or 'ws'. | auto |
| ONEBOT_TIMEOUT_MS | No | Timeout per call in milliseconds (positive integer). | 10000 |
| ONEBOT_ACCESS_TOKEN | No | The access token used when the HTTP and WS tokens are the same. | |
| ONEBOT_WS_ACCESS_TOKEN | No | Override WS access token when HTTP and WS tokens differ. | |
| ONEBOT_HTTP_ACCESS_TOKEN | No | Override HTTP access token when HTTP and WS tokens differ. |
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": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_login_infoA | 查询当前登录 QQ 的昵称与 QQ 号。只读,不改任何状态。 |
| get_statusA | 查询 OneBot 运行状态与收发统计。只读。 |
| get_version_infoA | 查询协议端版本与应用名。只读。 |
| get_friend_listA | 拉取全部好友列表。只读;好友多时结果会很长。 |
| get_group_listA | 拉取已加入的群列表。只读;no_cache=true 强制刷新。 |
| get_group_infoB | 按群号查群资料(群名、人数等)。只读。 |
| get_group_member_listB | 拉某个群的成员列表。只读;大群一次几百上千条。 |
| get_group_member_infoB | 查指定 QQ 在某个群里的资料(名片、角色等)。只读。 |
| get_msgB | 按 message_id 取一条消息的原文与发送者。只读。 |
| get_forward_msgA | 取合并转发中的内容;id 或 message_id 传一个即可。只读。 |
| get_imageA | 取图片信息与下载地址;file 或 file_id 传一个。只读。 |
| get_recordA | 取语音信息;out_format 可转码。file/file_id 传一个。只读。 |
| get_cookiesA | 取指定域名的 Cookie。等于交出登录凭据,别往群里或日志里贴。 |
| get_csrf_tokenB | 取 CSRF Token(bkn)。属于登录凭据,别外传。 |
| delete_msgB | 撤回一条已发出去的消息。会改变会话状态:消息会被抹掉。 |
| set_group_kickB | 把成员踢出群。会改变对方的状态,且不可撤销。 |
| set_group_banB | 禁言群成员(秒),0=解除禁言。会改变对方的状态。 |
| set_group_whole_banA | 开或关全员禁言。会改变整个群的状态。 |
| set_group_adminB | 设置或取消管理员。会改变对方在该群的权限。 |
| set_group_cardB | 改成员的群名片,传空串可清除。会改变对方在该群的展示。 |
| set_group_nameA | 改群名。会改变整个群的状态,所有人可见。 |
| set_group_leaveA | 退出指定群。会改变群的状态,退了得重新加。 |
| set_group_special_titleB | 设置成员专属头衔,空串清除。会改变对方在群里的称谓。 |
| set_friend_add_requestA | 同意或拒绝好友申请。会改变双方的好友关系。 |
| set_group_add_requestC | 同意或拒绝加群申请。会改变群的成员构成。 |
| send_likeB | 给好友点赞,默认 1 次。会改变对方的点赞数。 |
| set_group_signA | 在指定群打卡签到。会留下你的签到记录。 |
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 27 tools
Every tool targets a distinct resource plus action: get_* queries are cleanly separated by target (version, login, status, friend_list, group_list, group_info, member_list, member_info, msg, forward_msg, image, record, cookies, csrf_token), and set_* management actions each modify a clearly different attribute. There is no meaningful overlap between any two tools.
The get_/set_ verb_noun pattern dominates and is applied consistently across the large majority of tools, and what reads as 'set' vs 'kick/admin/ban' maps to the underlying OneBot action names. Minor deviations like send_like and delete_msg break the prefix scheme but remain readable and memorable.
27 tools is on the heavy side, but they map one-to-one onto distinct OneBot11 API actions (queries, media, credentials, group administration, requests), so each largely earns its place. It is slightly over the ideal range but not bloated with redundancy.
The set covers querying, media retrieval, credentials, and extensive group administration, but the most essential chat operation — sending a message (send_msg / send_group_msg / send_private_msg) — is entirely absent, along with message history and friend-request listing. For a messaging bot this is a notable and surprising gap.