Skip to content
Back to search

qidian-live-mcp

??????? MCP ??(MCP server for the Qidian live workbench)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/guanhaisong--qidian-live-mcp/badge.svg)](/listings/guanhaisong--qidian-live-mcp)

HTML

<a href="/listings/guanhaisong--qidian-live-mcp"><img src="/api/listings/guanhaisong--qidian-live-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:主播(安装包自带,推荐)

装完「麒典直播工作台」后,安装目录里会有 `mcp.json`。直接把它里面的内容贴进编辑器的 MCP 配置即可:

{
  "mcpServers": {
    "qidian-live": {
      "command": "C:\\Users\\你\\AppData\\Local\\麒典直播工作台\\runtime\\python\\python.exe",
      "args": ["C:\\Users\\你\\AppData\\Local\\麒典直播工作台\\工作台\\mcp_server.py"]
    }
  }
}

路径照抄 `mcp.json` 里的真实值,不要照抄上面的示例。

方式二:开发者(clone 本仓库)

`mcp_server.py` 只依赖 Python 标准库,不需要 `pip install`:

{
  "mcpServers": {
    "qidian-live": {
      "command": "python",
      "args": ["D:\\路径\\qidian-live-mcp\\mcp_server.py"]
    }
  }
}

工作台装在别的机器、或改了端口,就加一个环境变量:

{
  "mcpServers": {
    "qidian-live": {
      "command": "python",
      "args": ["D:\\路径\\qidian-live-mcp\\mcp_server.py"],
      "env": { "QIDIAN_HOST": "http://127.0.0.1:8788" }
    }
  }
}

方式三:npm(上架后可用)

{
  "mcpServers": {
    "qidian-live": {
      "command": "npx",
      "args": ["-y", "qidian-live-mcp"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 156 lines
  1. # qidian-live-mcp
  2. [![license](https://img.shields.io/npm/l/qidian-live-mcp.svg)](./LICENSE)
  3. 麒典直播工作台的 MCP 服务。让 TRAE / Cursor / Claude / Codex 这类支持 MCP 的编辑器,直接在对话里查看直播状态、开播停止、跑自检、复盘留人数据、改写口播稿。
  4. > 这个包只是「遥控器」。真正的直播能力在本地工作台(Windows 应用),两者通过 `127.0.0.1:8787` 通信。
  5. >
  6. > npm 包暂未上架(发布流程见文末),目前用**本机路径**方式接入,效果完全一样。
  7. ## 谁能用
  8. 只要客户端**跑在主播这台电脑上、并且支持 stdio 型 MCP**,就能用,配置都是同一段 JSON:
  9. | 客户端 | 可用 | 说明 |
  10. | --- | --- | --- |
  11. | TRAE / Cursor / Windsurf / Cline / Continue | 是 | 桌面端,填 `mcpServers` |
  12. | Claude Desktop / Claude Code | 是 | Desktop 用 `claude_desktop_config.json`;Code 用 `claude mcp add` |
  13. | Codex CLI / VS Code + Copilot | 是 | 支持本地 stdio MCP |
  14. | 豆包网页、扣子/Coze、百度智能体等云端 | 否 | 它们跑在厂商服务器上,连不到主播电脑的 `127.0.0.1:8787` |
  15. 云端智能体要接,只有把它们能访问的公网 MCP 地址暴露出来,那等于把直播间控制口开放到公网,需要单独做鉴权和限流,本项目不做。
  16. ## 前提
  17. 1. 本机已安装并启动「麒典直播工作台」(Windows 应用,双击桌面快捷方式,台面打开即算起来)。
  18. 2. 方式一、二用 Python 3.10+(安装包自带运行时,不用另装);方式三用 Node.js ≥ 18。
  19. 工作台没启动时,所有工具都会返回一句「工作台没启动」,不会报错崩溃。
  20. ## 安装
  21. ### 方式一:主播(安装包自带,推荐)
  22. 装完「麒典直播工作台」后,安装目录里会有 `mcp.json`。直接把它里面的内容贴进编辑器的 MCP 配置即可:
  23. ```json
  24. {
  25. "mcpServers": {
  26. "qidian-live": {
  27. "command": "C:\\Users\\你\\AppData\\Local\\麒典直播工作台\\runtime\\python\\python.exe",
  28. "args": ["C:\\Users\\你\\AppData\\Local\\麒典直播工作台\\工作台\\mcp_server.py"]
  29. }
  30. }
  31. }
  32. ```
  33. 路径照抄 `mcp.json` 里的真实值,不要照抄上面的示例。
  34. ### 方式二:开发者(clone 本仓库)
  35. `mcp_server.py` 只依赖 Python 标准库,不需要 `pip install`:
  36. ```json
  37. {
  38. "mcpServers": {
  39. "qidian-live": {
  40. "command": "python",
  41. "args": ["D:\\路径\\qidian-live-mcp\\mcp_server.py"]
  42. }
  43. }
  44. }
  45. ```
  46. 工作台装在别的机器、或改了端口,就加一个环境变量:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "qidian-live": {
  51. "command": "python",
  52. "args": ["D:\\路径\\qidian-live-mcp\\mcp_server.py"],
  53. "env": { "QIDIAN_HOST": "http://127.0.0.1:8788" }
  54. }
  55. }
  56. }
  57. ```
  58. ### 方式三:npm(上架后可用)
  59. ```json
  60. {
  61. "mcpServers": {
  62. "qidian-live": {
  63. "command": "npx",
  64. "args": ["-y", "qidian-live-mcp"]
  65. }
  66. }
  67. }
  68. ```
  69. ## 能做什么(11 个工具)
  70. | 工具 | 作用 |
  71. | --- | --- |
  72. | `qidian_state` | 是否在播、轮次、当前段和第几句、在线/看过/评论、掉人最多段、需求榜、合规计数、救场次数、告警、最近日志 |
  73. | `qidian_start` / `qidian_stop` | 开播 / 停止 |
  74. | `qidian_pause` | 暂停或继续(`on: true/false`) |
  75. | `qidian_selftest` | 七项体检:稿子 / 语音 / 大屏 / 弹幕 / 声卡 / 合规词 / 开场钩子 |
  76. | `qidian_stay` | 段落留人表:净掉人数、段内掉得最狠那句、TOP3 |
  77. | `qidian_kw` | 观众需求榜(按次数) |
  78. | `qidian_log` | 最近运行日志 |
  79. | `qidian_fix` | 给掉人最多的段生成 3 个改法 |
  80. | `qidian_fix_apply` | 选定一版写回 `话术.md`(写入前扫违禁词) |
  81. | `qidian_ask` | 按知识库 + 红线试答一条弹幕,不开口播 |
  82. ## 合规
  83. - 这个工具是**真人主播的副驾**,不是无人直播。开播必须真人出镜,平台明确禁止无人/录播。
  84. - 所有口播走工作台的护栏:命中联系方式、收益承诺、绝对化、利益诱导等违禁词,那一句会被跳过。
  85. - `qidian_fix_apply` 写回前会再扫一遍,命中直接拒绝。
  86. - 本仓库不含任何直播平台账号、抓取脚本或绕过风控的实现。
  87. ## 常见问题
  88. **连上了但每个工具都提示「工作台没启动」**
  89. 先双击工作台快捷方式,等台面出来(约 5 秒)再重试。
  90. **`npx` 卡住不动**
  91. 国内网络换 `npm i -g qidian-live-mcp` 再用手册第二种配置。
  92. **改了端口**
  93. 工作台默认 8787;换了就在 `env` 里设 `QIDIAN_HOST`。
  94. ## 开发
  95. ```bash
  96. git clone <this repo>
  97. cd qidian-live-mcp
  98. node bin/qidian-live-mcp.js # 直接跑,stdin 收 JSON-RPC
  99. ```
  100. 零依赖,没有 `npm install` 这一步。
  101. ## 发布 / 上架(维护者看)
  102. MCP 生态里"一次开发、到处能装"靠三样东西:统一协议、npm 包、官方目录。对应到本仓库:
  103. 1. `package.json` 里的 `mcpName`(形如 `io.github.<用户名>/qidian-live`)
  104. 2. `server.json`(声明 `registryType: npm` + `transport: stdio`)
  105. 3. npm 包本体(官方目录只存元数据,不存包)
  106. `publish.ps1` 会把前两样按当前登录的 GitHub 用户名自动补好,再提示剩下的授权步骤:
  107. ```powershell
  108. powershell -ExecutionPolicy Bypass -File .\publish.ps1 # 体检 + 生成 + 下载 publisher
  109. npm publish --access public
  110. mcp-publisher login github
  111. mcp-publisher publish
  112. ```
  113. `-CheckOnly` 只体检不发布。
  114. ## License
  115. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.