关于 MnogoReels
MnogoReels 是一款 MCP 服务,可将长视频制作为竖屏短片、文字稿和文章。创作者可通过 MCP 客户端提交支持的视频链接,并使用自己的 MnogoReels 账户处理内容。
主要功能
- 01将长视频制作成 9:16 竖屏短片
- 02挑选精彩片段并添加吸引标题
- 03为短片烧录字幕
- 04生成文字稿和文章
- 05接收多个平台的视频链接
适用场景
- 01将长篇录制内容剪成短视频
- 02根据视频生成文字稿和文章
- 03为在线视频制作带字幕的 Reels 或 Shorts
MCP 相关
向 MCP 客户端提供 MnogoReels 视频处理能力,可通过托管的 Streamable HTTP 服务或本地 stdio 服务连接。只读托管端点不包含创建任务的工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.mnogo-reels.ru/mcpclaude mcp add --transport http ru-mnogo-reels-mnogoreels https://mcp.mnogo-reels.ru/mcp{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}在 Cursor 中打开{"servers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}在 VS Code 中打开{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"serverUrl":"https://mcp.mnogo-reels.ru/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.mnogo-reels.ru/mcp需要授权https://mcp.mnogo-reels.ru/mcp/readonly需要授权工具
19此工具无需参数。
详细介绍
English | Русский
MnogoReels MCP 服务
MnogoReels MCP 服务:将长视频转换为带字幕的竖屏 Shorts/Reels、转录文本和文章,可通过任意 MCP 客户端使用。向 AI 助手提供 YouTube、VK Video、RuTube、Dzen、Twitch、Yandex Disk、Google Drive 或直接视频链接,它就会挑选最佳片段,将画面调整为 9:16,嵌入字幕和吸引眼球的标题,并使用你自己的 MnogoReels 账户返回成品视频链接。
一键安装
应用直达链接(如果按钮无法打开你的编辑器)
GitHub 不会将 cursor:// 和 vscode: 链接渲染为可点击链接,因此请将其中一个复制到浏览器地址栏。
Cursor,托管版:
cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJ1cmwiOiJodHRwczovL21jcC5tbm9nby1yZWVscy5ydS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D
Cursor,本地版:
cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1ub2dvcmVlbHMtbWNwQGxhdGVzdCJdLCJlbnYiOnsiTU5PR09SRUVMU19BUElfS0VZIjoiJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D
VS Code,托管版(会提示输入密钥):
vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D
VS Code,本地版(会提示输入密钥):
vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mnogoreels-mcp%40latest%22%5D%2C%22env%22%3A%7B%22MNOGOREELS_API_KEY%22%3A%22%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D
Claude Desktop 安装包(.mcpb)会打开安装对话框,提示输入密钥,并可选设置只读开关。Goose 链接和其他所有客户端都列在快速开始中。
获取 API 密钥
- 在 mnogo-reels.ru 登录或注册。
- 打开 开发者 → API 密钥,然后创建密钥。密钥以
mrfrt_usr_开头。 - 按照下方说明将密钥填入客户端配置(本地服务使用
MNOGOREELS_API_KEY,托管服务使用Authorization: Bearer标头)。
密钥可能会消耗你的额度。 为每个客户端或设备单独使用一个密钥,切勿将其粘贴到聊天、问题或 URL 中;不再需要时,请在同一页面撤销密钥。
列出工具无需密钥;对于新的链接,get_account、get_options_guide、check_video_source 和 quote_clip_job 也无需密钥。所有读取你的任务或创建新任务的操作都需要密钥。
快速开始
托管服务(推荐)
URL:https://mcp.mnogo-reels.ru/mcp(Streamable HTTP)。在标头中发送密钥:
{
"mcpServers": {
"mnogoreels": {
"type": "http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
}
}
}
- 如果你的客户端无法设置
Authorization,则改为发送X-API-Key: mrfrt_usr_YOUR_KEY。 https://mcp.mnogo-reels.ru/mcp/readonly是同一服务,但不包含任何会创建任务或消耗额度的工具。- 切勿将密钥放入 URL:服务会拒绝此类请求。
本地服务(stdio)
需要 Node.js 22 或更高版本。服务会从你的设备直接与 https://api.mnogo-reels.ru 通信。
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
"type": "http" 是 Claude Code、VS Code 和 Cursor 使用的写法。Cline 需要 "streamableHttp",Windsurf 需要 serverUrl,Gemini CLI 需要 httpUrl;下方各客户端配置块中提供了准确格式。可在 examples/ 中找到现成文件;docs/clients.md 中则有各客户端的详细说明。
Claude Code
托管版:
claude mcp add --transport http mnogoreels https://mcp.mnogo-reels.ru/mcp --header "Authorization: Bearer mrfrt_usr_YOUR_KEY"
本地版:
claude mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest
插件(托管服务加上 make-shorts skill;启用时会提示输入密钥):
/plugin marketplace add RealSatanyan/mnogoreels-mcp
/plugin install mnogoreels@mnogoreels
Claude Desktop
下载 mnogoreels-mcp.mcpb,然后双击(或将其拖入“设置”→“扩展”)。Claude Desktop 会提示输入 API 密钥,并使用内置的 Node.js 运行服务。
或者,将本地服务添加到 claude_desktop_config.json(“设置”→“开发者”→“编辑配置”):
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
个人 Claude Desktop 用户无法使用带有静态 API 密钥标头的自定义远程连接器,因此请使用安装包或本地服务。
Cursor
使用上方的按钮,或添加到 ~/.cursor/mcp.json(所有项目)或 .cursor/mcp.json(单个项目):
{
"mcpServers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
}
}
}
本地版本:使用上方的本地服务配置块;如果将密钥保存在环境变量中,请使用 "MNOGOREELS_API_KEY": "${env:MNOGOREELS_API_KEY}"。
VS Code(GitHub Copilot)
使用上方的按钮,或创建 .vscode/mcp.json。VS Code 会提示输入一次密钥,并安全地保存:
{
"inputs": [
{
"type": "promptString",
"id": "mnogoreels_api_key",
"description": "MnogoReels API key (mrfrt_usr_...)",
"password": true
}
],
"servers": {
"mnogoreels": {
"type": "http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${input:mnogoreels_api_key}" }
}
}
}
工作区中的 .mcp.json 使用托管服务中的 mcpServers 格式;切勿提交包含密钥的文件。
OpenAI Codex
`~/.codex/config.toml`,托管模式(在启动 Codex 的 shell 中导出 `MNOGOREELS_API_KEY`):[mcp_servers.mnogoreels]
url = "https://mcp.mnogo-reels.ru/mcp"
bearer_token_env_var = "MNOGOREELS_API_KEY"
tool_timeout_sec = 120
本地模式:
[mcp_servers.mnogoreels]
command = "npx"
args = ["-y", "mnogoreels-mcp@latest"]
env_vars = ["MNOGOREELS_API_KEY"]
startup_timeout_sec = 60
tool_timeout_sec = 120
或通过命令行:
codex mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest
默认的 10 秒启动超时通常不足以完成首次 npx 下载,因此设置 startup_timeout_sec = 60。
Gemini CLI
安装扩展(它会请求密钥并将其保存在系统密钥链中):
gemini extensions install https://github.com/RealSatanyan/mnogoreels-mcp
或将托管服务添加到 ~/.gemini/settings.json:
{
"mcpServers": {
"mnogoreels": {
"httpUrl": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer $MNOGOREELS_API_KEY" }
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"mnogoreels": {
"serverUrl": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
}
}
}
Zed
settings.json,托管模式:
{
"context_servers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
}
}
}
本地模式:
{
"context_servers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
Cline
将以下代码块之一添加到 cline_mcp_settings.json。本地模式:
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" },
"disabled": false,
"autoApprove": []
}
}
}
托管模式:
{
"mcpServers": {
"mnogoreels": {
"type": "streamableHttp",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" },
"disabled": false,
"autoApprove": []
}
}
}
远程条目中绝不能省略 type:如果远程条目没有 type,Cline 会将其视为旧版 SSE,而此服务不提供该协议。Cline 也可以根据 llms-install.md 自动配置服务。
Goose
将以下链接之一粘贴到浏览器地址栏中(GitHub 不会将 goose:// 链接渲染为可点击链接)。本地模式,Goose 会请求密钥:
goose://extension?name=MnogoReels&cmd=npx&arg=-y&arg=mnogoreels-mcp%40latest&env=MNOGOREELS_API_KEY%3DMnogoReels%20API%20key%20(mrfrt_usr_...)&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles
托管模式,打开前请替换 mrfrt_usr_YOUR_KEY:
goose://extension?name=MnogoReels&url=https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp&header=Authorization%3DBearer%20mrfrt_usr_YOUR_KEY&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles
或者运行 goose configure → Add Extension → Command-line Extension,命令填写 npx -y mnogoreels-mcp@latest,变量填写 MNOGOREELS_API_KEY。config.yaml 示例见 examples/goose-config.yaml。
Kiro
使用上方的按钮,或添加到 ~/.kiro/settings/mcp.json(或项目中的 .kiro/settings/mcp.json):
{
"mcpServers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${MNOGOREELS_API_KEY}" }
}
}
}
JetBrains AI Assistant, Warp, Amazon Q, LM Studio
这些客户端接受通用的 mcpServers JSON:将托管模式或本地模式代码块粘贴到它们的 MCP 设置中(JetBrains:Settings → Tools → AI Assistant → Model Context Protocol;Warp:Settings → AI → MCP servers;Amazon Q:~/.aws/amazonq/mcp.json;LM Studio:mcp.json)。如果客户端不支持带标头的远程服务,请使用本地代码块。
Continue
保存为 .continue/mcpServers/mnogoreels.yaml,并在 Continue 中添加密钥 MNOGOREELS_API_KEY:
name: MnogoReels
version: 1.0.0
schema: v1
mcpServers:
- name: MnogoReels
type: streamable-http
url: https://mcp.mnogo-reels.ru/mcp
requestOptions:
headers:
Authorization: 'Bearer ${{ secrets.MNOGOREELS_API_KEY }}'
n8n
将 MCP Client Tool 节点添加到你的 AI Agent:
- 服务传输:HTTP Streamable
- 端点:
https://mcp.mnogo-reels.ru/mcp - 身份验证:使用名称为
Authorization、值为Bearer mrfrt_usr_YOUR_KEY的 Header Auth
详情:examples/n8n.md。
Yandex AI Studio (MCP Hub)
AI Studio → MCP Hub → «Внешний MCP-сервер»(外部 MCP 服务):
- 名称:
mnogoreels - URL:
https://mcp.mnogo-reels.ru/mcp - 传输方式:Streamable HTTP
- 标头:
Authorization: Bearer mrfrt_usr_YOUR_KEY
Cloud.ru Evolution AI Agents
AI Agents → MCP servers → 按 URL 添加服务:https://mcp.mnogo-reels.ru/mcp,并设置标头 Authorization: Bearer mrfrt_usr_YOUR_KEY。
GigaChain / LangChain (Python)
使用 langchain-mcp-adapters:
import os
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient(
{
"mnogoreels": {
"transport": "streamable_http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": {"Authorization": "Bearer " + os.environ["MNOGOREELS_API_KEY"]},
}
}
)
tools = await client.get_tools()
将 tools 传递给你的 GigaChat Agent。可运行脚本见 examples/gigachain.py。
Docker
镜像默认运行本地(stdio)服务:
docker run -i --rm -e MNOGOREELS_API_KEY ghcr.io/realsatanyan/mnogoreels-mcp:latest
作为 MCP 客户端条目:
{
"mcpServers": {
"mnogoreels": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "MNOGOREELS_API_KEY", "ghcr.io/realsatanyan/mnogoreels-mcp:latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
用日常语言向助手提问,例如:
- “用 hormozi 风格的俄语字幕,从 https://www.youtube.com/watch?v=… 制作 Shorts。先告诉我价格。”
- “剪辑这期播客的前 30 分钟需要多少积分?播客时长为 2 小时。”
- “转录这段 RuTube 视频,并给我 SRT 字幕。”
- “根据我最近一次剪辑任务,撰写一篇带章节的博客文章。”
- “显示我最近的剪辑任务,以及每个任务中最好的三个片段、它们的评分和链接。”
工具
| 工具 | 标题 | 只读 | 消耗额度 | 功能说明 |
|---|---|---|---|---|
get_account | 检查 API 密钥和设置 | 是 | 否 | 检查配置的 MnogoReels API 密钥是否有效,并显示此服务的设置。 |
get_options_guide | 说明片段选项 | 是 | 否 | 说明 create_clip_job 和 recut_clip_job 接受的选项值:视频模式、片段时长、字幕样式、钩子样式、故事弧线样式、片尾、画面构图和语言,以及定价规则和每个任务 30 分钟的时长限制。 |
check_video_source | 检查视频来源 | 是 | 否 | 检查 MnogoReels 是否能下载视频链接,并返回视频标题、时长和平台。 |
quote_clip_job | 估算片段任务费用 | 是 | 否 | 计算 create_clip_job 或 recut_clip_job 的额度费用,不会实际消耗额度,并检查 MnogoReels 是否能下载视频。 |
create_clip_job | 创建片段任务(消耗额度) | 否 | 是 | 启动 AI 剪辑,将长视频剪成竖屏 9:16 短片,添加烧录式字幕和钩子标题,并可选择添加冷开场钩子、音乐和 B-roll。 |
get_clip_job | 获取片段任务状态和片段 | 是 | 否 | 返回通过 create_clip_job、recut_clip_job 或 MnogoReels 网站创建的片段任务的状态、进度和结果。 |
list_clip_jobs | 列出片段任务 | 是 | 否 | 按时间从新到旧列出用户的片段任务,包括在 MnogoReels 网站上启动的任务。 |
recut_clip_job | 重新剪辑片段任务(消耗额度) | 否 | 是 | 使用现有任务的同一视频来源创建新的片段任务,并应用不同设置,例如字幕样式、钩子样式、片段时长、语言、画面构图、音乐、B-roll 或提示词。 |
retry_clip_job | 重试失败的片段任务(免费) | 否 | 否 | 使用相同设置重新运行失败的片段任务,不收取费用,并保留相同的 job_id。 |
create_transcription | 转录视频或音频 | 否 | 否 | 启动对视频或音频链接的带时间戳语音转文字转录。 |
get_transcription | 获取转录内容 | 是 | 否 | 返回通过 create_transcription 启动的转录任务的状态和文本。 |
create_article | 根据片段任务创建文章 | 否 | 否 | 将已完成片段任务的视频来源转换为长篇文章:标题、SEO 标题和描述、摘要、章节、要点、带时间戳的章节、最多 4 张视频画面插图,以及完整的带时间戳转录文本。 |
get_article | 获取文章 | 是 | 否 | 以 Markdown 格式返回通过 create_article 创建的文章及其状态。 |
search_broll | 搜索 B-roll 素材库 | 是 | 否 | 搜索 B-roll 视频和图片。 |
get_broll_asset | 获取 B-roll 素材 | 是 | 否 | 根据 asset_id 返回一项 B-roll 素材及其最新链接。 |
list_packs | 列出发布套件 | 是 | 否 | 按时间从新到旧列出用户的发布套件。 |
get_pack | 获取发布套件 | 是 | 否 | 返回一个发布套件:建议标题、描述、封面文案和标签、缩略图、预告视频、文章 ID 和片段任务 ID。 |
create_youtube_thumbnails | 创建 YouTube 缩略图 | 否 | 否 | 为视频生成 1 到 4 张 AI YouTube 缩略图(1280×720 JPEG),使用视频画面,并可选择添加标题和艺术指导。 |
get_youtube_thumbnails | 获取 YouTube 缩略图 | 是 | 否 | 返回通过 create_youtube_thumbnails 启动的缩略图任务的状态和图片。 |
每个工具都声明了标题、全部四项 MCP 注解(readOnlyHint、destructiveHint、idempotentHint、openWorldHint)以及输出架构。两个消耗额度的工具都标记为 destructiveHint: true,因此,对于会在执行风险操作前征求确认的客户端(例如 Claude 和 Codex),每次调用时都会提示你确认。
如何选择工具
| 我想要…… | 工具 |
|---|---|
| 确认链接是否有效以及视频时长 | check_video_source |
| 创建片段前了解价格 | quote_clip_job |
| 创建片段 | create_clip_job(报价并获得你的同意后) |
| 跟踪进度并获取片段 | get_clip_job |
| 查找我之前的任务(包括在网站上创建的任务) | list_clip_jobs |
| 为已完成的任务换一种风格或选取不同片段 | recut_clip_job(付费,会创建新任务) |
| 重新运行失败的任务 | retry_clip_job(免费) |
| 获取文字稿或 SRT 字幕 | create_transcription → get_transcription |
| 获取博客文章、节目笔记或章节 | create_article → get_article(需要已完成的片段任务) |
| 查找 B-roll 素材 | search_broll → get_broll_asset |
| 阅读在网站上制作的出版素材包 | list_packs → get_pack |
| 制作 YouTube 缩略图 | create_youtube_thumbnails → get_youtube_thumbnails |
| 检查我的密钥和服务设置 | get_account |
| 了解字幕样式、模式和其他选项 | get_options_guide |
任务在后台运行
每个 create_* 工具都会立即返回一个 id。对应的 get_* 工具会在调用中等待,最长等待 wait_sec 秒(默认值为 30,最大值为 50),并在此期间发送进度通知,因此助手只需重复调用该工具,直到状态为 completed 或 failed。短视频需要几分钟;完整的 30 分钟片段范围可能需要几十分钟。片段任务处理期间,get_clip_job 只会返回已就绪片段的数量(设置 include_partial_clips=true 可提前查看这些片段)。
费用规则
- **价格:**按处理范围内每开始一分钟收费 1 个积分(
end_sec − start_sec),最低收费 1 个积分,在创建任务时扣除。例如:45 秒 → 1 个积分,10 分钟 → 10 个积分,29 分 30 秒 → 30 个积分。通过 API 使用字幕、钩子、B-roll、音乐和 Agent 模式不会改变价格。 - **免费:**检查、报价、文字稿、文章、YouTube 缩略图、失败任务的重试以及读取结果。
- 先报价:
quote_clip_job免费,且使用与后端相同的公式。助手应向你显示价格并等待你的同意。 create_clip_job和recut_clip_job必须提供max_credits。如果价格更高,调用会被拒绝且不会扣费。运营方也可以使用MNOGOREELS_MAX_CREDITS_PER_CALL或X-MnogoReels-Max-Credits-Per-Call标头设置硬性上限,模型无法提高该上限。- 每个任务最长 30 分钟。 MnogoReels 每个任务最多处理 30 分钟,超出此范围的请求会在扣费前被拒绝。使用
start_sec/end_sec拆分长视频(0–1800、1800–3600,依此类推)。 - **重复请求保护:**10 分钟内使用相同密钥发出的完全相同请求会返回已创建的任务,而不会再次扣费(设置
allow_duplicate: true可关闭此功能)。此保护仅在单个服务进程内有效;两个不同的进程不会共享该保护。 - **无法取消,不自动退款。**创建任务时即会扣除积分,且任务无法取消。如果处理失败,积分不会自动退回;
retry_clip_job可免费重新运行失败的任务,或者通过 job 的job_id联系 [email protected]。 - **确认对话框。**如果客户端支持 MCP 表单征询,服务还会在扣费前请你确认确切金额:
| 服务运行位置 | 扣费前是否显示确认对话框 |
|---|---|
本地服务(stdio、npx、.mcpb、Docker),以及支持表单征询的任意客户端 | 是 |
| 托管服务,运行 MCP 2026-07-28 的客户端且支持表单征询 | 是 |
| 托管服务,使用 2025 年前后版本的客户端(目前大多数客户端) | 否:max_credits、运营方上限、30 分钟限制、重复请求保护以及客户端自身的审批提示会共同把关 |
| 不支持征询功能的任意客户端 | 否:适用上述相同的把关措施 |
提示词和资源
提示词(客户端中用于显示提示词的斜杠命令):
| 提示词 | 功能 |
|---|---|
clip_video | 引用报价、确认、创建并等待生成一个链接中的片段(url,可选的 language、caption_style、clip_length) |
podcast_to_shorts | 将长播客拆分为 30 分钟的部分,逐个报价,制作 Shorts 系列并建议发布顺序(url,可选的 language) |
video_to_blog_post | 将已完成的片段任务转换为文章和章节列表(clip_job_id) |
transcribe_video | 将链接转录为文本或 SRT(url,可选的 language、format) |
review_recent_clips | 查看最近的任务,并建议重新剪辑设置,不产生任何费用(可选的 count) |
资源:
| URI | 内容 |
|---|---|
mnogoreels://guide/options | 所有选项值及其说明 |
mnogoreels://guide/pricing | 定价、30 分钟限制和免费操作列表 |
mnogoreels://guide/workflow | 工具使用方法(与服务说明中的文本相同) |
mnogoreels://clip-jobs/{job_id} | 一个任务的状态和片段(JSON;列出最近的 20 个任务) |
mnogoreels://transcriptions/{transcription_id} | 转录文本的第一页 |
mnogoreels://articles/{article_id} | 文章的第一页(Markdown 格式) |
只有启用了相应工具时,提示词和任务资源才会显示(例如,/mcp/readonly 仅提供 review_recent_clips)。每项功能也都可以通过工具使用,因为许多客户端不会显示资源。
配置
环境变量(本地服务和自托管)
| 变量 | 默认值 | 含义 |
|---|---|---|
MNOGOREELS_API_KEY | 无 | 你的密钥(mrfrt_usr_…)。启动服务或列出工具时不需要。在 HTTP 模式下会被忽略,因为每个调用方都会发送自己的密钥。 |
MNOGOREELS_API_URL | https://api.mnogo-reels.ru | API 基础 URL;保留默认值。 |
MNOGOREELS_PROFILE | default | default、readonly 或 directory(参见配置档案)。 |
MNOGOREELS_TOOLSETS | all | 以逗号分隔的 clips、transcripts、articles、library、thumbnails 列表(或 all)。account 始终启用。 |
MNOGOREELS_READ_ONLY | false | true 会隐藏所有创建任务或消耗额度的工具。 |
MNOGOREELS_MAX_CREDITS_PER_CALL | 未设置 | 每次付费调用的额度上限;模型无法覆盖此限制。 |
MNOGOREELS_MAX_WINDOW_SEC | 1800 | 每个付费任务的最长范围,以秒为单位。保留默认值:它与 MnogoReels 的处理范围相符。 |
MNOGOREELS_MEDIA_URLS | direct | both 还会返回通过 MnogoReels 网站代理的 stream_url 链接。在 MnogoReels 宣布该代理可供 API 使用之前,请保留 direct。 |
MNOGOREELS_DEBUG | false | 仅适用于本地服务:将完整错误消息记录到 stderr。 |
MNOGOREELS_TRANSPORT | stdio | http 会启动 Streamable HTTP 服务(与 --http 相同)。 |
MNOGOREELS_HOST / MNOGOREELS_PORT | 127.0.0.1 / 8080 | HTTP 绑定地址。 |
MNOGOREELS_PUBLIC_URL | https://mcp.mnogo-reels.ru/mcp | 服务卡片中公布的公共 URL。 |
MNOGOREELS_ALLOWED_HOSTS | localhost,127.0.0.1,[::1] | 接受的 Host 标头(DNS 重绑定防护)。 |
MNOGOREELS_ALLOWED_ORIGINS | localhost,127.0.0.1,[::1] | 接受的浏览器 Origin 主机名;公开的持有者令牌部署可使用 *。 |
MNOGOREELS_TRUSTED_PROXIES | 空 | 其 X-Forwarded-For 可信的反向代理 CIDR。 |
布尔值接受 1/true/yes/on 和 0/false/no/off。无效值会导致服务停止,并显示变量名称(退出代码 2)。命令行:mnogoreels-mcp [--http] [--help] [--version]。
托管服务:路径和标头
| 路径 | 配置 |
|---|---|
/mcp | default |
/mcp/readonly | readonly |
/mcp/directory | directory |
| 标头 | 作用 |
|---|---|
Authorization: Bearer <key> | 你的 API 密钥(首选)。 |
X-API-Key: <key> | 在无法使用 Authorization 时使用的 API 密钥。 |
X-MnogoReels-Toolsets: clips,transcripts | 仅显示这些工具集(始终保留 account)。 |
X-MnogoReels-Read-Only: true | 隐藏会创建任务或消耗点数的工具。false 不会扩大只读路径允许的范围。 |
X-MnogoReels-Max-Credits-Per-Call: 30 | 每次付费调用的点数上限。 |
标头只能缩小路径允许的范围。无需密钥即可发现和列出工具;需要密钥的工具调用若未提供密钥,则会返回 HTTP 401。
配置
| 配置 | 工具 | 变化内容 |
|---|---|---|
default | 19 | 全部工具。 |
readonly | 13 | 不包含会创建任务或消耗点数的工具;读取、检查和报价功能仍可使用。 |
directory | 17 | 不包含 YouTube 缩略图工具、AI 图像或动态图形 B-roll 选项,也不包含“购买点数”链接。用于公开目录列表。 |
自托管 HTTP 服务
npx -y mnogoreels-mcp@latest --http 或 docker run -p 8080:8080 -e MNOGOREELS_TRANSPORT=http ghcr.io/realsatanyan/mnogoreels-mcp:latest 会启动与 mcp.mnogo-reels.ru 上运行的相同服务(健康检查:GET /healthz,服务卡片:GET /.well-known/mcp/server-card.json)。将 MNOGOREELS_ALLOWED_HOSTS 设置为你的域名。生产环境的配置说明见 docs/deploy-coolify.md。
安全
- 不可信内容。 视频中的标题、转录文本、文章和其他文本都用
<untrusted_source_text>标签包裹,服务指令会告知模型将其视为数据,而不是指令。 - 密钥安全。 密钥仅通过
Authorization或X-API-Key标头传输(托管服务会拒绝 URL 中的密钥),绝不会记录在日志中,get_account只会显示密钥末尾 4 个字符。请为每个客户端使用专用密钥,并撤销不再使用的密钥。服务密钥(mrfrt_svc_…)会被拒绝。 - 只读模式。
MNOGOREELS_READ_ONLY=true、/mcp/readonly路径或 Claude Desktop bundle 中的只读开关都会移除所有可能创建任务或消耗点数的工具。 - 仅限官方来源。 服务仅通过 npm 包
mnogoreels-mcp、镜像ghcr.io/realsatanyan/mnogoreels-mcp、托管端点https://mcp.mnogo-reels.ru和本仓库发布。不要向仿冒者提供你的密钥。 - 固定版本。
mnogoreels-mcp@latest会自动更新。若要避免自动更新,请固定版本,例如npx -y [email protected]。
私下报告漏洞:请参阅 SECURITY.md。
隐私
本地服务只会将你的工具参数和密钥发送到 api.mnogo-reels.ru。托管服务会在 mcp.mnogo-reels.ru 接收这些内容,并转发到相同的 API;它只会在请求期间将密钥保存在内存中,绝不会记录密钥、工具参数或结果(只记录密钥的短哈希前缀,以区分用户)。不会收集任何遥测数据。详情请参阅 PRIVACY.md、MnogoReels 的隐私政策和条款。
故障排除
工具错误以 Error [<code>]: 开头,后面附有处理建议。最常见的错误如下:
| 代码 | 处理方法 |
|---|---|
missing_api_key、invalid_api_key_format、invalid_api_key(托管服务上的 HTTP 401) | 在 Developers → API keys 创建密钥,并更新客户端配置。密钥以 mrfrt_usr_ 开头。运行 get_account 进行检查。 |
insufficient_credits(402) | 在 mnogo-reels.ru 充值或购买套餐。 |
duration_unknown | 平台未报告视频时长(直接文件链接通常会出现此情况)。传入 end_sec(时长秒数,或待处理片段的结束时间)。 |
invalid_arguments 中提到 30 分钟 | 单个任务最多处理 30 分钟。使用 start_sec/end_sec 拆分视频,并创建多个任务。 |
source_not_downloadable | 视频为私有、已移除、受地区限制、仅含音频或大于 17 GB。不会扣费。请尝试其他链接。 |
rate_limited、rate_limited_local | 请求过多;请等待错误消息中所示的秒数。 |
upstream_timeout | MnogoReels 未能及时响应;请重试。检查来源时,也可以自行传入 start_sec/end_sec。 |
outcome_unknown、billing_uncertain | 服务端无法确认是否已创建付费任务。重试前请检查 list_clip_jobs;如果已扣费但没有创建任务,请联系 [email protected]。在 10 分钟内进行相同的重试会返回相同结果,不会发送任何内容。 |
| Codex:工具超时或服务未启动 | 在 config.toml 中设置 startup_timeout_sec = 60 和 tool_timeout_sec = 120。 |
| 在俄罗斯下载缓慢或失败 | 一些俄罗斯家庭网络会限制 API 和媒体主机的流量。使用家庭网络时,建议优先使用托管服务。启用 MNOGOREELS_MEDIA_URLS=both 后,如果 MnogoReels 为 API 用途启用了代理,就会添加经过代理的 stream_url 链接。 |
仍然无法解决?请提交问题(请先从日志和配置中移除密钥),或发送邮件至 [email protected]。
限制(v1)
- 不支持本地文件:视频必须可通过公开链接访问(请先将视频上传到公开位置)。
- 不提供信用额度余额:API 不会公开此信息;请在 mnogo-reels.ru 查看。
- 不支持向社交网络发布内容或安排发布时间。
- 不支持取消任务。
- 可以读取发布包,但无法创建;失败的文章图片无法重试。
开发
要求:Node.js 22+。代码使用 TypeScript(严格模式),通过 tsc 构建,使用 Vitest 和 Stryker 测试,并采用测试先行的开发方式。
npm ci --ignore-scripts
npm run typecheck && npm run lint && npm test
npm run build
npm run test:integration
npm run smoke # MCP Inspector CLI smoke test
npm run version:check # manifests in sync with package.json
npm run metadata:check # README tool tables, MCPB tools, Docker tools.json up to date
工作流请参阅 CONTRIBUTING.md,发布流程请参阅 docs/release.md。更改记录列于 CHANGELOG.md。所有参与者都应遵守行为准则。
许可证
MIT © 2026 MnogoReels
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。