mcpField
M
MnogoReels

MnogoReels

远程服务
github.com媒体与设计01 周前更新

关于 MnogoReels

MnogoReels 是一款 MCP 服务,可将长视频制作为竖屏短片、文字稿和文章。创作者可通过 MCP 客户端提交支持的视频链接,并使用自己的 MnogoReels 账户处理内容。

主要功能

  1. 01将长视频制作成 9:16 竖屏短片
  2. 02挑选精彩片段并添加吸引标题
  3. 03为短片烧录字幕
  4. 04生成文字稿和文章
  5. 05接收多个平台的视频链接

适用场景

  1. 01将长篇录制内容剪成短视频
  2. 02根据视频生成文字稿和文章
  3. 03为在线视频制作带字幕的 Reels 或 Shorts

MCP 相关

向 MCP 客户端提供 MnogoReels 视频处理能力,可通过托管的 Streamable HTTP 服务或本地 stdio 服务连接。只读托管端点不包含创建任务的工具。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.mnogo-reels.ru/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://mcp.mnogo-reels.ru/mcp需要授权
Streamable HTTPhttps://mcp.mnogo-reels.ru/mcp/readonly需要授权
安装包
npmmnogoreels-mcp1.0.0
ocighcr.io/realsatanyan/mnogoreels-mcp:1.0.0
mcpbmnogoreels-mcp-1.0.0.mcpb1.0.0

工具

19

此工具无需参数。

详细介绍

English | Русский

MnogoReels MCP 服务

MnogoReels MCP 服务:将长视频转换为带字幕的竖屏 Shorts/Reels、转录文本和文章,可通过任意 MCP 客户端使用。向 AI 助手提供 YouTube、VK Video、RuTube、Dzen、Twitch、Yandex Disk、Google Drive 或直接视频链接,它就会挑选最佳片段,将画面调整为 9:16,嵌入字幕和吸引眼球的标题,并使用你自己的 MnogoReels 账户返回成品视频链接。

npm version npm downloads CI License: MIT MCP 2026-07-28 MCP Registry Glama score Smithery Docker image

一键安装

客户端托管服务(无需安装)本地服务(Node.js 22+,npx)
Cursor在 Cursor 中安装在 Cursor 中安装
VS Code在 VS Code 中安装在 VS Code 中安装
VS Code Insiders在 VS Code Insiders 中安装在 VS Code Insiders 中安装
Kiro添加到 Kiro添加到 Kiro
Claude Desktop不支持使用 API 密钥(见下文)下载 Claude Desktop 版
SmitherySmithery
Cursor 和 Kiro 按钮需要在环境中设置 MNOGOREELS_API_KEY;设置后重启编辑器,或在编辑器打开的配置中将 ${env:…} 替换为你的密钥。VS Code 按钮会提示输入密钥。
应用直达链接(如果按钮无法打开你的编辑器)

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 密钥

  1. 在 mnogo-reels.ru 登录或注册。
  2. 打开 开发者 → API 密钥,然后创建密钥。密钥以 mrfrt_usr_ 开头。
  3. 按照下方说明将密钥填入客户端配置(本地服务使用 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

详情:examples/yandex-ai-studio.md。

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_URLhttps://api.mnogo-reels.ruAPI 基础 URL;保留默认值。
MNOGOREELS_PROFILEdefaultdefault、readonly 或 directory(参见配置档案)。
MNOGOREELS_TOOLSETSall以逗号分隔的 clips、transcripts、articles、library、thumbnails 列表(或 all)。account 始终启用。
MNOGOREELS_READ_ONLYfalsetrue 会隐藏所有创建任务或消耗额度的工具。
MNOGOREELS_MAX_CREDITS_PER_CALL未设置每次付费调用的额度上限;模型无法覆盖此限制。
MNOGOREELS_MAX_WINDOW_SEC1800每个付费任务的最长范围,以秒为单位。保留默认值:它与 MnogoReels 的处理范围相符。
MNOGOREELS_MEDIA_URLSdirectboth 还会返回通过 MnogoReels 网站代理的 stream_url 链接。在 MnogoReels 宣布该代理可供 API 使用之前,请保留 direct。
MNOGOREELS_DEBUGfalse仅适用于本地服务:将完整错误消息记录到 stderr。
MNOGOREELS_TRANSPORTstdiohttp 会启动 Streamable HTTP 服务(与 --http 相同)。
MNOGOREELS_HOST / MNOGOREELS_PORT127.0.0.1 / 8080HTTP 绑定地址。
MNOGOREELS_PUBLIC_URLhttps://mcp.mnogo-reels.ru/mcp服务卡片中公布的公共 URL。
MNOGOREELS_ALLOWED_HOSTSlocalhost,127.0.0.1,[::1]接受的 Host 标头(DNS 重绑定防护)。
MNOGOREELS_ALLOWED_ORIGINSlocalhost,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]。

托管服务:路径和标头
路径配置
/mcpdefault
/mcp/readonlyreadonly
/mcp/directorydirectory
标头作用
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。

配置
配置工具变化内容
default19全部工具。
readonly13不包含会创建任务或消耗点数的工具;读取、检查和报价功能仍可使用。
directory17不包含 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_timeoutMnogoReels 未能及时响应;请重试。检查来源时,也可以自行传入 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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。