qidian-live-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
qidian-live-mcp
麒典直播工作台的 MCP 服务。让 TRAE / Cursor / Claude / Codex 这类支持 MCP 的编辑器,直接在对话里查看直播状态、开播停止、跑自检、复盘留人数据、改写口播稿。
这个包只是「遥控器」。真正的直播能力在本地工作台(Windows 应用),两者通过
127.0.0.1:8787通信。npm 包暂未上架(发布流程见文末),目前用本机路径方式接入,效果完全一样。
谁能用
只要客户端跑在主播这台电脑上、并且支持 stdio 型 MCP,就能用,配置都是同一段 JSON:
客户端 | 可用 | 说明 |
TRAE / Cursor / Windsurf / Cline / Continue | 是 | 桌面端,填 |
Claude Desktop / Claude Code | 是 | Desktop 用 |
Codex CLI / VS Code + Copilot | 是 | 支持本地 stdio MCP |
豆包网页、扣子/Coze、百度智能体等云端 | 否 | 它们跑在厂商服务器上,连不到主播电脑的 |
云端智能体要接,只有把它们能访问的公网 MCP 地址暴露出来,那等于把直播间控制口开放到公网,需要单独做鉴权和限流,本项目不做。
Related MCP server: BlackHole
前提
本机已安装并启动「麒典直播工作台」(Windows 应用,双击桌面快捷方式,台面打开即算起来)。
方式一、二用 Python 3.10+(安装包自带运行时,不用另装);方式三用 Node.js ≥ 18。
工作台没启动时,所有工具都会返回一句「工作台没启动」,不会报错崩溃。
安装
方式一:主播(安装包自带,推荐)
装完「麒典直播工作台」后,安装目录里会有 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"]
}
}
}能做什么(11 个工具)
工具 | 作用 |
| 是否在播、轮次、当前段和第几句、在线/看过/评论、掉人最多段、需求榜、合规计数、救场次数、告警、最近日志 |
| 开播 / 停止 |
| 暂停或继续( |
| 七项体检:稿子 / 语音 / 大屏 / 弹幕 / 声卡 / 合规词 / 开场钩子 |
| 段落留人表:净掉人数、段内掉得最狠那句、TOP3 |
| 观众需求榜(按次数) |
| 最近运行日志 |
| 给掉人最多的段生成 3 个改法 |
| 选定一版写回 |
| 按知识库 + 红线试答一条弹幕,不开口播 |
合规
这个工具是真人主播的副驾,不是无人直播。开播必须真人出镜,平台明确禁止无人/录播。
所有口播走工作台的护栏:命中联系方式、收益承诺、绝对化、利益诱导等违禁词,那一句会被跳过。
qidian_fix_apply写回前会再扫一遍,命中直接拒绝。本仓库不含任何直播平台账号、抓取脚本或绕过风控的实现。
常见问题
连上了但每个工具都提示「工作台没启动」 先双击工作台快捷方式,等台面出来(约 5 秒)再重试。
npx 卡住不动
国内网络换 npm i -g qidian-live-mcp 再用手册第二种配置。
改了端口
工作台默认 8787;换了就在 env 里设 QIDIAN_HOST。
开发
git clone <this repo>
cd qidian-live-mcp
node bin/qidian-live-mcp.js # 直接跑,stdin 收 JSON-RPC零依赖,没有 npm install 这一步。
发布 / 上架(维护者看)
MCP 生态里"一次开发、到处能装"靠三样东西:统一协议、npm 包、官方目录。对应到本仓库:
package.json里的mcpName(形如io.github.<用户名>/qidian-live)server.json(声明registryType: npm+transport: stdio)npm 包本体(官方目录只存元数据,不存包)
publish.ps1 会把前两样按当前登录的 GitHub 用户名自动补好,再提示剩下的授权步骤:
powershell -ExecutionPolicy Bypass -File .\publish.ps1 # 体检 + 生成 + 下载 publisher
npm publish --access public
mcp-publisher login github
mcp-publisher publish-CheckOnly 只体检不发布。
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server for AI.TV creators — delegate account operations to your AI agent over MCP.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceLocal stdio MCP server for working on Intern-hosted sites through guarded Git checkouts. It enables authentication, site preparation, testing, validation, and publishing via coding harnesses like Codex and Claude Code.37 npmMIT
- AlicenseNot gradedqualityCmaintenanceBridges web-based AI agents to a local VS Code workspace over MCP Streamable HTTP, letting them inspect files, edit code, and run persistent shell commands within session-scoped boundaries. Risky, destructive, or out-of-scope operations pause for explicit human approval, with session state surviving reconnects.8 npmGPL 3.0
- AlicenseCqualityFmaintenanceThis MCP server gives an AI coding host controlled, client-agnostic access to a local machine's developer capabilities: transactional file edits, shell and PTY execution, Git and project inspection, language-server operations, isolated browser automation, Windows UI automation, VS Code state, durable jobs, and checkpoints, all bounded by filesystem root allowlisting and resource admission controls. It speaks standard MCP over stdio, Streamable HTTP, and legacy HTTP+SSE, and can also run headless as a long-lived job runner without any hosted model vendor.114ISC
- AlicenseNot gradedqualityCmaintenanceEnables supervised control of OBS Studio over obs-websocket v5, including scene and input management, audio/filter toggles, and starting or stopping streams, recordings, replay buffer, and virtual camera, with dry-run writes and redacted secrets. It also supports a rate-limited chat co-producer for Twitch, YouTube, Kick, and X that maps privileged viewer commands to OBS scene changes.MIT