1. Conduid
  2. Commerce
  3. MCP
MCP server · Commerce

MCP

by · github.com/SnowLuma/SnowLuma

Next Remote Protocol Framework.

Unclaimed bot-frameworksnowluma
InstallView source
67Good

Scored 5 hours ago · breakdown

About MCP

MCP is an MCP server published by SnowLuma in the Commerce category: next Remote Protocol Framework.

The repository has 1.7K stars and 102 forks, with the last commit 4 hours ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add mcp-e2a5 -- npx -y @snowluma/mcp
npx
npx -y @snowluma/mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about MCP

Powered by Claude · Grounded in docs

I know everything about MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 4 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.

1 check has not been run yet.

Releases

v1.14.22v1.14.22 · 7 Oct 2026SnowLuma v1.14.22 跨平台正式支持： Windows x64、Linux x64 与 Linux arm64 均可完整运行 SnowLuma，包含 QQ 接入、OneBot v11 与 WebUI 管理能力。 选择下载 | 平台 | 完整版（内置 Node.js，推荐） | Lite（Node.js 22.13+；23 系需 23.4+） | | --- | --- | --- | | Windows x64 |…
v1.14.21v1.14.21 · 4 Oct 2026SnowLuma v1.14.21 跨平台正式支持： Windows x64、Linux x64 与 Linux arm64 均可完整运行 SnowLuma，包含 QQ 接入、OneBot v11 与 WebUI 管理能力。 选择下载 | 平台 | 完整版（内置 Node.js，推荐） | Lite（Node.js 22.13+；23 系需 23.4+） | | --- | --- | --- | | Windows x64 |…
v1.14.20v1.14.20 · 26 Sep 2026SnowLuma v1.14.20 跨平台正式支持： Windows x64、Linux x64 与 Linux arm64 均可完整运行 SnowLuma，包含 QQ 接入、OneBot v11 与 WebUI 管理能力。 选择下载 | 平台 | 完整版（内置 Node.js，推荐） | Lite（Node.js 22.13+；23 系需 23.4+） | | --- | --- | --- | | Windows x64 |…
v1.14.19v1.14.19 · 21 Sep 2026SnowLuma v1.14.19 跨平台正式支持： Windows x64、Linux x64 与 Linux arm64 均可完整运行 SnowLuma，包含 QQ 接入、OneBot v11 与 WebUI 管理能力。 选择下载 | 平台 | 完整版（内置 Node.js，推荐） | Lite（Node.js 22.13+；23 系需 23.4+） | | --- | --- | --- | | Windows x64 |…
v1.14.18v1.14.18 · 21 Sep 2026SnowLuma v1.14.18 跨平台正式支持： Windows x64、Linux x64 与 Linux arm64 均可完整运行 SnowLuma，包含 QQ 接入、OneBot v11 与 WebUI 管理能力。 选择下载 | 平台 | 完整版（内置 Node.js，推荐） | Lite（Node.js 22.13+；23 系需 23.4+） | | --- | --- | --- | | Windows x64 |…

README

SnowLuma 是面向 QQ 客户端的 TypeScript 互操作运行时，将 QQ 原生会话转换为 OneBot v11 动作与事件，并通过 WebSocket、HTTP、WebUI、SDK 和 MCP 提供统一入口。

[!CAUTION] SnowLuma 是独立的第三方项目，与腾讯 / QQ 无隶属或授权关系。项目仅供学习与技术研究，请遵守《QQ 用户协议》及适用法律；软件按“现状”提供，使用风险自负。详见 EULA.md。

Disclaimer: SnowLuma is independent of Tencent / QQ and is provided for study and research only, “as is” and without warranty.

核心能力

场景 能力
OneBot 接入 OneBot v11 动作与事件；WebSocket 服务端 / 客户端及 HTTP 服务端 / 上报
消息与媒体 文本、图片、语音、视频、文件、回复、提及、转发及常见卡片
多账号运行 各账号独立维护会话、身份映射、消息存储和网络配置
WebUI 管理 账号状态、实时日志、连接配置、动作调试和存储管理
开发者工具 @snowluma/sdk 与 @snowluma/mcp

运行链路

会话接入、协议解析、身份映射、OneBot 转换和网络适配保持独立边界；多个 QQ 账号可并行运行。

快速开始

  1. 从 Releases 下载对应平台的完整发行包并解压。Lite 版需 Node.js 22.13+（23 系需 23.4+）。

  2. Windows 运行 launcher.bat；Linux 执行：

    chmod +x launcher.sh
./launcher.sh

  3. 打开 http://localhost:5099，使用启动日志中的初始密码登录 WebUI，按引导接入 QQ 进程并配置 OneBot 连接。

接入与文档

入口 文档
WebSocket / HTTP OneBot 动作参考
TypeScript SDK packages/sdk/README.md
MCP packages/mcp/README.md

JSON 消息段接受标准的 data.data 字符串，也兼容 data.data 非数组对象和 { type: "json", data: "..." } 简写；data 必填，最终内容必须是 JSON 对象。

开发

需要 Node.js 22.13+（23 系需 23.4+）与 pnpm 10.28.0，日常开发基于 dev 分支：

git clone https://github.com/SnowLuma/SnowLuma.git
cd SnowLuma
git checkout dev
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test

贡献流程见 CONTRIBUTING.md；模块边界与项目词汇见 CONTEXT.md；开发方向见 RoadMap.md。

引用消息预览

OneBot 发送 reply 段时，会将本地消息缓存中的原文附入 QQ 引用预览，保留文字、换行与引用关系。图片、语音等非文字段以类型提示显示，不重新上传媒体；原消息中的嵌套引用不递归展开。只有消息元数据而没有缓存正文时，不生成虚构的预览内容。

使用边界与许可

[!IMPORTANT] SnowLuma 使用源码可见非商业许可，不是 OSI 开源许可。源码可用于查看、学习、非商业自托管及私下修改；商业使用，以及公开发布修改版或衍生版，均需事先取得书面授权。

完整条款见 LICENSE；二进制发行包另受 EULA.md 与 PRIVACY.md 约束；商业授权请联系 motricseven@foxmail.com。随附的原生附加组件为专有组件，不在源码许可范围内。

SnowLuma is source-available for study and non-commercial self-hosting, but it is not OSI open source. Commercial use and public distribution of modified or derivative versions require prior written permission.

社区与鸣谢

项目参考了 LagrangeV2 的协议定义与 NapCatQQ 的实现思路。

README fetched from the repository 4 hours ago. The original is authoritative.

Questions

About MCP

How do I install MCP?

Run claude mcp add mcp-e2a5 -- npx -y @snowluma/mcp, then add the server to your MCP client's configuration.

Is MCP safe to use with an AI agent?

Its trust score is 67 out of 100 (good). It passes 4 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is MCP still maintained?

Yes — the latest release is v1.14.22 (7 Oct 2026), and the last commit was 4 hours ago. The repository has 1.7K stars and 22 open issues.