Skip to main content
Glama
irmia2026

onebot11-mcp

by irmia2026

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ONEBOT_WS_URLNoForward WebSocket URL; set to 'none' to disable this channel.ws://127.0.0.1:3001
ONEBOT_HTTP_URLNoHTTP adapter URL; set to 'none' to disable this channel.http://127.0.0.1:3000
ONEBOT_READONLYNoSet to '1' to register only query tools; write operations will not appear in tools/list.
ONEBOT_TRANSPORTNoTransport selection: 'auto' (HTTP first, fallback to WS), 'http', or 'ws'.auto
ONEBOT_TIMEOUT_MSNoTimeout per call in milliseconds (positive integer).10000
ONEBOT_ACCESS_TOKENNoThe access token used when the HTTP and WS tokens are the same.
ONEBOT_WS_ACCESS_TOKENNoOverride WS access token when HTTP and WS tokens differ.
ONEBOT_HTTP_ACCESS_TOKENNoOverride 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

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 27 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues