yunxin-console-mcp

网易云信控制台 MCP Server。官方 yunxin-mcp-server 覆盖的是服务端 IM/RTC API；本项目补全应用后台管理能力：应用管理、AppKey/AppSecret、 回调、证书、推送配置、IM 功能开关、测试账号、敏感词、数字人和统计。

非官方项目：本项目调用云信控制台内部 frontApi，与网易云信无官方关联。 控制台升级后接口可能变化；请仅用于管理你拥有权限的账号，并遵守云信服务条款。

功能

• 应用管理：应用列表、应用详情、创建/修改应用、AppKey/AppSecret
• 应用配置：标识管理、推送证书、第三方回调、消息抄送（只读）、IP 白名单、自定义推送、第三方推送分类、功能变更记录
• IM 管理：完整 IM 配置读取、按字段更新、测试账号、敏感词、安全通/反垃圾、机器人、数字人、存储清理
• 数据统计：用户增长、地域分布、IM 消息数、群组/聊天室/推送/安全通、功能使用统计
• 通用兜底：yunxin_api_call 可调用任意 /frontApi 接口，覆盖尚未封装的能力

环境要求

• Node.js 20+
• 本机安装 Google Chrome 或 Microsoft Edge（仅首次登录使用）

安装

从 npm 安装：

npx -y @devdengchao/yunxin-console-mcp --version
npm install -g @devdengchao/yunxin-console-mcp

直接从 GitHub 安装（会自动构建）：

npx -y github:DevDengChao/yunxin-console-mcp

从源码运行：

git clone https://github.com/DevDengChao/yunxin-console-mcp.git
cd yunxin-console-mcp
npm install
npm run build

首次登录

控制台使用 Cookie 会话。运行一次：

npx -y @devdengchao/yunxin-console-mcp login

会打开一个专用 Chrome 配置窗口。登录成功后会保存 Cookie 到用户配置目录并自动关闭浏览器。 之后 MCP Server 直接使用该会话，不再需要浏览器常驻。

如果不想打开浏览器，也可以从 DevTools 的 Network 面板复制请求头里的 Cookie：

npx -y @devdengchao/yunxin-console-mcp auth import --cookie "cookie1=value1; cookie2=value2"

或者直接在 Network 面板右键请求 → Copy → Copy as cURL，然后粘贴：

npx -y @devdengchao/yunxin-console-mcp auth import --curl "curl 'https://app.yunxin.163.com/frontApi/...' -H 'cookie: ...'"
# 或把内容保存到文件
npx -y @devdengchao/yunxin-console-mcp auth import --curl-file curl.txt

检查登录态：

npx -y @devdengchao/yunxin-console-mcp auth status

退出登录：

npx -y @devdengchao/yunxin-console-mcp auth logout

MCP 客户端配置

Claude Desktop / Cursor / OpenCode 等支持 stdio 的客户端：

{
  "mcpServers": {
    "yunxin-console": {
      "command": "npx",
      "args": ["-y", "@devdengchao/yunxin-console-mcp"],
      "env": {
        "YUNXIN_CONSOLE_DEFAULT_APP": "your-app"
      }
    }
  }
}

如果从源码运行，把 command 改为 node，args 改为 ["E:/path/to/yunxin-console-mcp/dist/cli.js"]。

工具列表

多数工具使用 action 参数区分读写操作；app 参数支持应用名称或 appid。

安全模型

• 写操作默认开启。如需只读模式，设置 YUNXIN_CONSOLE_ALLOW_WRITE=false。
• 删除、重置密钥、封禁、发布、存储清理等破坏性操作必须传 confirm: true。
• AppSecret 默认打码；需要完整值时显式传 includeSecret: true。
• 所有非 GET 请求写入本地审计日志，Cookie、AppSecret、Token 等字段自动脱敏。
• 审计日志默认位于：
  • Windows：%APPDATA%\yunxin-console-mcp\audit.log
  • macOS/Linux：~/.config/yunxin-console-mcp/audit.log

环境变量

验证情况

详细记录见 docs/verification.md。账号、应用和数据均已脱敏。

• 58 个单元/集成测试通过，覆盖 Cookie 会话、HTTP 错误映射、应用解析、IM 配置映射、统计日期和审计日志。
• 已在真实控制台环境跑通只读工具：应用列表、应用详情、IM 配置、测试账号、用户统计、IM 消息统计、应用设置、证书、IP 白名单。
• 已通过 MCP 工具执行 as-is 无副作用写测试：deletemsgtime、roaming、sendMsgCheckFriend、chatroomIONoNotify、publishoffline、updateInfo 全部返回 res:200，回读配置无变化。

复跑实时只读冒烟：

npm run smoke

已知限制

• 控制台内部 API 可能随前端升级变化；接口集中在 src/api/，便于修复。
• 登录态失效后需要重新执行 login，目前不会自动刷新。
• 消息抄送写操作、IM 总开关映射、数字人新增等少量接口尚未做真实写测试，已标记为待验证。
• 当前应用下敏感词列表接口返回「参数错误」，控制台页面同样报错；安全通未开通时配置接口会返回未开通提示。
• 其他产品（RTC、短信、点播、直播、白板、大模型 API）暂未封装专用工具，可通过 yunxin_api_call 调用。

开发

npm install
npm run build
npm test
node dist/cli.js login
node dist/cli.js auth status

发布

发布使用 npm Trusted Publisher + GitHub OIDC，不需要长期 NPM_TOKEN。 首次配置见 docs/release.md。

发布新版本：

npm version patch
git push --follow-tags

License

MIT