MovieClaw

文档/功能

AI 助手、MCP 与命令行

用一句话让 MovieClaw 订阅、洗版、整理片库；或者让 ChatGPT、Claude、Cursor 等外部 Agent 通过 MCP 和命令行 mclaw 操作全部功能。

最后核对：2026-10-04

MovieClaw 把一个通用 Agent 集成进了影音服务器：你说一句话，它自己去搜索、订阅、洗版、整理片库、生成字幕，每一步调用了什么都看得见。 同一套能力也开放给外部：任何 Agent 都能通过 MCP 或命令行 mclaw 操作网页上能做的全部事情。

内置的 AI 助手

  1. 「设置 → 模型接入」添加大模型供应商。预设了 OpenAI、阿里云百炼、DeepSeek、智谱 GLM、Kimi，也能填任意兼容 OpenAI 接口的地址（比如自建的 vLLM、SiliconFlow、OpenRouter），可以同时接多家。
  2. 「设置 → AI 设定」选智能体和字幕处理默认用哪个模型。
  3. 回到首页，在对话框里直接说，比如「把《三体》订阅上，要 4K 的」「把 1 号库里文件名乱的整理一下」。

安全边界写在代码里：凭证不会交给命令行工具；删除这类危险操作必须你确认，删除的文件先进回收站。

在聊天软件里用

「设置 → 消息推送」可以绑定微信、Telegram、Discord，在里面直接和 AI 助手对话、收通知；飞书目前只推送通知。从聊天软件进来的对话只开放受限的工具。

让外部 Agent 接入：MCP

  1. 管理员到「设置 → MCP 服务」新建一个端点，勾选开放哪些能力。每个端点有独立的令牌，可以随时吊销。
  2. 在 Agent 里填端点地址和令牌。完整地址在「MCP 服务」页上可以直接复制，形如下面这样（以 Claude Code 为例）：
claude mcp add --transport http movieclaw http://192.168.1.10:3000/mcp/<端点名> \
  --header "Authorization: Bearer <令牌>"

Cursor、Cline 和自建 Agent 在配置文件里填同样的地址和 Authorization 请求头即可。端点用 MCP 的 Streamable HTTP 传输、静态令牌鉴权，所以需要 OAuth 的网页版连接器暂时接不进来。

命令行 mclaw

mclaw 是一个静态二进制，不依赖 Python 或 Node。服务器的镜像里已经带了（docker exec -it movieclaw mclaw status）， 别的机器一条命令装好：

# Linux、macOS
curl -fsSL https://raw.githubusercontent.com/movieclaw/movieclaw/main/scripts/install-cli.sh | sh

# Windows（PowerShell）
irm https://raw.githubusercontent.com/movieclaw/movieclaw/main/scripts/install-cli.ps1 | iex

装好后配对并使用：

mclaw login --server http://192.168.1.10:3000   # 配对，局域网内可以不带地址
mclaw status                                    # 服务器与授权状态
mclaw search titles "三体"                      # 搜影视条目
mclaw subscriptions list                        # 看订阅
mclaw subscriptions --help                      # 每个命令都有 --help

mclaw login 会显示一段配对码，到网页「设置 → 设备」核对后批准。命令树由服务器的接口自动生成，后端多一项功能，命令行就多一项能力； 在管道和 Agent 里默认输出 JSON；删除这类操作必须加 --yes。所以任何能跑 shell 的 Agent，装上它就能操作 MovieClaw。