NapCat MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NAPCAT_HOST | No | NapCat server address | http://localhost:3000 |
| NAPCAT_TOKEN | No | NapCat access token | |
| READONLY_MODE | No | Read-only mode (true/false) | false |
| ALLOWED_GROUPS | No | Allowed group numbers (comma-separated), empty=all |
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_group_infoC | Get group detailed information |
| get_group_listB | Get list of all joined groups |
| get_group_honor_infoC | Get group honor information |
| get_group_at_all_remainB | Get remaining @all count for group |
| get_group_info_exC | Get group detailed information (extended) |
| get_group_member_listD | Get group member list |
| get_group_member_infoB | Get specified group member detailed info |
| get_group_root_filesB | Get group root directory file list |
| get_group_files_by_folderB | Get file list in specified group folder |
| get_group_file_system_infoB | Get group file system information |
| get_group_file_urlC | Get group file download URL |
| get_group_msg_historyC | Get group message history with IDs and structured OneBot fields for pagination or follow-up actions |
| read_group_messagesA | Read recent group messages as a minimal human-readable timeline. Prefer this for understanding chat; use get_group_msg_history only when IDs, pagination, or raw segments are needed. |
| get_group_announcement_listC | Get group announcement list |
| get_essence_msg_listC | Get group essence message list |
| get_group_system_msgC | Get group system messages |
| get_group_ignore_add_requestC | Get group ignored join requests |
| send_msgC | Send message (generic) |
| send_group_msgC | Send group message |
| send_private_msgC | Send private message |
| delete_msgC | Recall message |
| get_msgC | Get message details |
| get_forward_msgC | Get forward message |
| send_group_forward_msgC | Send group forward message |
| mark_msg_as_readC | Mark message as read |
| set_group_kickB | Kick member from group |
| set_group_banC | Mute group member |
| set_group_whole_banB | Mute all members in group |
| set_group_adminB | Set group admin |
| set_group_cardC | Set group member card |
| set_group_nameC | Set group name |
| set_group_leaveC | Leave or dismiss group |
| set_group_special_titleB | Set group special title |
| set_group_add_requestC | Handle group join request |
| upload_group_fileC | Upload group file |
| delete_group_fileC | Delete group file |
| send_group_noticeC | Send group announcement |
| set_essence_msgD | Set essence message |
| delete_essence_msgC | Delete essence message |
| get_friend_listD | Get friend list |
| get_stranger_infoC | Get stranger information |
| get_friend_msg_historyC | Get friend message history |
| send_likeD | Send like |
| set_friend_add_requestC | Handle friend request |
| get_login_infoB | Get login account information |
| get_statusC | Get running status |
| get_version_infoC | Get version information |
| get_cookiesD | Get cookies |
| get_csrf_tokenC | Get CSRF token |
| get_credentialsC | Get credentials |
| ocr_imageC | OCR image recognition |
| get_imageC | Get image information |
| get_recordC | Get voice record information |
| can_send_imageB | Check if can send image |
| can_send_recordB | Check if can send voice record |
| get_online_clientB | Get online client list |
| set_qq_profileC | Set QQ profile |
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 57 tools
Most tools are distinct, but there is overlap: get_group_info and get_group_info_ex, get_group_msg_history and read_group_messages (though descriptions differentiate), and get_csrf_token/get_credentials/get_cookies are similar. These could cause confusion.
All tools follow a consistent verb_noun pattern with snake_case, e.g., get_group_list, send_msg, set_group_kick, delete_msg. No mixed conventions.
With 57 tools, the server is heavily overloaded, especially for a single domain (QQ bot). Many are low-level APIs that could be consolidated; this exceeds typical well-scoped MCP servers.
The tool set covers most QQ group and friend operations including messaging, file management, announcements, and moderation. Minor gaps: no tool to get group member profile or send private files, but overall complete for core workflows.