MCPcopy Index your code
hub / github.com/NapNeko/NapCatQQ

github.com/NapNeko/NapCatQQ @v4.18.8

repository ↗ · DeepWiki ↗ · release v4.18.8 ↗ · Ask this repo → · + Follow
6,185 symbols 12,768 edges 828 files 377 documented · 6% updated todayv4.18.8 · 2026-07-03★ 9,7333 open issues
README

NapCat

NapCat

Modern protocol-side framework implemented based on NTQQ.

云起兮风生,心向远方兮路未曾至.


New Framework ?

可以试试更新更好用的 SnowLuma 作为NapCat Gui替代品。

Welcome

  • NapCatQQ is a modern implementation of the Bot protocol based on NTQQ.
  • NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现

Feature

  • Easy to Use
  • 作为初学者能够轻松使用.
  • Quick and Efficient
  • 在低内存操作系统长时运行.
  • Rich API Interface
  • 完整实现了大部分标准接口.
  • Stable and Reliable
  • 持续稳定的开发与维护.

Quick Start

可前往 Release 页面下载最新版本

首次使用请务必查看如下文档看使用教程

项目非盈利,涉及 对接问题/基础问题/下层框架问题 请自行搜索解决,本项目社区不提供此类解答。

Link

Docs Github.IO Cloudflare.Worker Cloudflare.HKServer
Docs Cloudflare.Pages Server.Other NapCat.Top
QQ Group NapCat Family Group 4 NapCat Family Group 3 NapCat Family Group 2 NapCat Family Group 1
Telegram Telegram
DeepWiki Ask DeepWiki

QQ群因为特殊原因需要入群密钥,请在webui关于页面获取,仅最新的100个版本以内有效。

社区相关日后会进一步加强审核,并严格限制一定时间的入群人数,请具备一定编程基础和问题解决能力再申请入群。

困困猫猫的高中

Thanks

  • Lagrange 对本项目的大力支持 参考部分代码 已获授权

  • AstrBot 是完美适配本项目的LLM Bot框架 在此推荐一下

  • MaiBot 一只赛博群友 麦麦 Bot框架 在此推荐一下

  • qq-chat-exporter 基于NapCat的消息导出工具 在此推荐一下

  • 不过最最重要的 还是需要感谢屏幕前的你哦~


License

本项目采用 混合协议 开源,因此使用本项目时,你需要注意以下几点:

  1. 第三方库代码或修改部分遵循其原始开源许可.
  2. 本项目获取部分项目授权而不受部分约束
  3. 项目其余逻辑代码采用本仓库开源许可.

本仓库仅用于提高易用性,实现消息推送类功能,此外,禁止任何项目未经仓库主作者授权基于 NapCat 代码开发。使用请遵守当地法律法规,由此造成的问题由使用者和提供违规使用教程者负责。

Extension points exported contracts — how you extend this code

ImageParser (Interface)
(no doc) [12 implementers]
packages/napcat-image-size/src/index.ts
RpcPair (Interface)
(no doc) [12 implementers]
packages/napcat-rpc/src/easy.ts
IProcessManager (Interface)
(no doc) [4 implementers]
packages/napcat-shell/process-api.ts
IProtocolAdapter (Interface)
(no doc) [4 implementers]
packages/napcat-adapter/index.ts
IFFmpegAdapter (Interface)
(no doc) [4 implementers]
packages/napcat-core/helper/ffmpeg/ffmpeg-adapter-interface.ts
IDisposable (Interface)
(no doc) [2 implementers]
packages/napcat-pty/node-pty.d.ts
MemoryStaticRoute (Interface)
内存静态路由定义
packages/napcat-onebot/network/plugin/router-registry.ts
IStatusHelperSubscription (Interface)
(no doc) [2 implementers]
packages/napcat-common/src/status-interface.ts

Core symbols most depended-on inside this repo

ProtoField
called by 1215
packages/napcat-protobuf/NapProto.ts
log
called by 236
packages/napcat-common/src/log-interface.ts
sendError
called by 232
packages/napcat-webui-backend/src/utils/response.ts
error
called by 229
packages/napcat-onebot/network/plugin/types.ts
push
called by 184
packages/napcat-core/packet/context/clientContext.ts
logError
called by 176
packages/napcat-common/src/log-interface.ts
get
called by 142
packages/napcat-core/wrapper.ts
catch
called by 124
packages/napcat-common/src/cancel-task.ts

Shape

Method 3,342
Function 1,152
Class 864
Interface 737
Enum 90

Languages

TypeScript100%
Python1%

Modules by API surface

packages/napcat-core/services/NodeIKernelMsgService.ts285 symbols
packages/napcat-core/services/NodeIKernelGroupService.ts171 symbols
packages/napcat-core/wrapper.ts155 symbols
packages/napcat-test/rpc.test.ts109 symbols
packages/napcat-core/services/NodeIKernelFlashTransferService.ts100 symbols
packages/napcat-core/listeners/NodeIKernelMsgListener.ts75 symbols
packages/napcat-core/packet/message/element.ts71 symbols
packages/napcat-core/services/NodeIKernelNodeMiscService.ts65 symbols
packages/napcat-onebot/network/plugin/types.ts63 symbols
packages/napcat-core/services/NodeIKernelRobotService.ts58 symbols
packages/napcat-core/services/NodeIKernelBuddyService.ts55 symbols
packages/napcat-core/apis/group.ts53 symbols

Dependencies from manifests, versioned

@codemirror/lang-css6.3.1 · 1×
@codemirror/lang-javascript6.2.4 · 1×
@codemirror/lang-json6.0.2 · 1×
@codemirror/theme-one-dark6.1.3 · 1×
@codemirror/view6.39.6 · 1×
@dnd-kit/core6.3.1 · 1×
@dnd-kit/sortable10.0.0 · 1×
@dnd-kit/utilities3.2.2 · 1×
@heroui/accordion2.2.8 · 1×
@heroui/avatar2.2.7 · 1×
@heroui/breadcrumbs2.2.7 · 1×
@heroui/button2.2.10 · 1×

For agents

$ claude mcp add NapCatQQ \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact