Fahi-Videos MCP Server

🎬 Fahi Videos 2.5V — 专业免费核心视频工作室与世界级 MCP 连接器

一站式浏览器视频创作、孟加拉国孟加拉语配音、多平台媒体下载器，以及面向 AI Agent 的完全免费优先型模型上下文协议（MCP）服务。

在线 Web 应用：https://fahi-videos.auraajenticai.cloud
在线 MCP 端点：https://fahi-videos.auraajenticai.cloud/mcp

---

🚀 主要功能（保证 100% 免费层级）

• 🎙️ Kotha Studio（কণ্ঠধ্বনি）：孟加拉国孟加拉语配音，提供 4 种预设人声（Kore、Puck、Charon、Zephyr）、3 级语音引擎（免费神经网络孟加拉语流 + 24kHz 合成 WAV 回退 + 可选 Gemini TTS），以及可容纳 64 条目的 FIFO 有界缓存。
• 📥 通用媒体下载器：完全免费的多引擎流提取，支持 YouTube、Facebook、Instagram Reels 和 TikTok，并支持 1080p/720p/MP3 流回退。
• ✂️ CapCut Pro 视频工作室：基于浏览器的 NLE 视频编辑，提供左对齐的 00:00:00:00 时间线、精确片段裁剪（minIn/maxOut）、关键帧缓动、CSS 遮罩形状、HSL/曲线调色，以及 .SRT 字幕渲染。
• ☁️ Supabase 云同步：预配置项目同步（https://spkrpwlavvbeooxijubv.supabase.co），支持用户身份验证、实时流量分析、一键封禁用户，以及离线草稿存储。
• 🛡️ 超级管理员门户（/admin）：完整的仪表板，包含实时分析、注册用户索引、一键 Supabase SQL 片段和系统配置。
• 🤖 世界级 MCP 连接器（/mcp）：提供 10 个免费优先型 MCP 工具、4 个工作室资源、3 个提示词，以及适用于 Claude Desktop、Cursor、Windsurf、Cline 和 Antigravity 的零依赖 stdio 桥接器。

---

🤖 世界级模型上下文协议（MCP）连接器

Fahi Videos 2.5V 实现了官方的 Model Context Protocol（MCP） 规范（协议版本 2024-11-05 和 2025-03-26），让 AI Agent 能够以编程方式控制视频制作、生成孟加拉语配音、制作 UGC 广告并提取媒体流。

🛠️ 10 个 MCP 工具

工具名称	描述	关键参数
fahi_generate_bangla_tts	通过 3 级回退生成自然的孟加拉语配音（WAV/MP3 base64）。	text、voiceName、durationSec
fahi_build_ugc_storyboard	制作多场景电商 UGC 分镜脚本，包含文案、Banglish 指南和 SRT。	productName、category、offerPriceBn、tone
fahi_translate_and_adapt_scene	将英文视频旁白翻译并进行文化适配，转换为本地化孟加拉语。	englishText、targetTone、targetAudience
fahi_generate_srt_subtitles	为孟加拉语旁白生成格式规范、带时间码的 .SRT 字幕。	text、durationSec、wordsPerSubtitle
fahi_extract_media_info	从 YouTube、Facebook、Instagram 和 TikTok 链接免费提取媒体流。	url
fahi_capcut_editor_blueprint	计算 CapCut Pro 时间线蓝图、分割、关键帧、转场和遮罩。	projectTitle、aspectRatio、maskShape、animIn
fahi_synthesize_studio_sfx	生成纯工作室级 16 位 WAV 音效（呼啸、弹出、点击、渐强等）。	sfxId（whoosh、pop、click、riser 等）
fahi_enhance_cinematic_prompt	将原始概念转换为具有孟加拉国特色的电影级视频/图像提示词。	prompt、mood、visualStyle、lighting
fahi_generate_image	通过免费回退生成电影级视觉场景或缩略图。	prompt、aspectRatio
fahi_crm_leads	查询、筛选并记录客户订单和 CRM 潜在客户。	action（list、capture、stats）、name、phone

📚 Studio 资源（resources/list 和 resources/read）

1. fahi://studio/capabilities：实时显示可用引擎和限制的清单。
2. fahi://voices/bangla-personas：孟加拉语语音角色描述及语调用例。
3. fahi://presets/capcut-blueprints：CapCut 宽高比、动画和 CSS 蒙版形状。
4. fahi://presets/ecommerce-categories：适用于时尚、数码产品、食品、护肤等领域的 UGC 营销结构。

💡 Studio 提示词（prompts/list 和 prompts/get）

1. bangla-ecommerce-ugc-campaign：端到端多场景电商广告制作。
2. free-yt-fb-insta-to-bangla-reel：将任意社交视频转换为本地化的孟加拉语短视频／Reel。
3. cinematic-bangladesh-veo-director：电影级视频导演提示词。

---

🔌 AI 客户端设置（Claude Desktop、Cursor、Windsurf）

1. Claude Desktop 设置

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "fahi-videos-mcp": {
      "command": "node",
      "args": ["D:/Fahi-videos/mcp-stdio-bridge.mjs"],
      "env": {
        "FAHI_MCP_URL": "https://fahi-videos.auraajenticai.cloud/mcp"
      }
    }
  }
}

2. Cursor IDE 设置

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "fahi-videos-mcp": {
      "httpUrl": "https://fahi-videos.auraajenticai.cloud/mcp"
    }
  }
}

3. 本地 Stdio 桥接程序运行

你可以在任意终端中本地运行桥接程序：

npm run mcp:stdio

---

🧪 验证与自动化测试套件

Fahi Videos 2.5V 包含覆盖所有引擎的综合测试套件：

# Run all automated test suites
npm run test:aura            # Aura Studio & Veo generation tests
npm run test:kotha           # Kotha Studio voiceover & SRT tests
npm run test:capcut          # CapCut Pro timeline & grading tests
npm run test:editor          # Timeline export & audio mix tests
npm run test:downloader      # Universal media downloader tests
npm run test:mcp             # World-Class MCP Connector test suite
npm run test:managed-worker  # Vertex AI managed queue tests

# Strict TypeScript typecheck
npm run typecheck

---

🛠️ 开发与部署

前置条件

• Node.js 18+（已在 Node.js 20 和 25 上测试）
• npm 或 bun

本地设置

git clone https://github.com/khondokartowsif171/Fahi-Videos-2.5V.git
cd Fahi-Videos-2.5V
npm install
npm run dev

在浏览器中打开 http://localhost:3000。

---

📄 许可证

专有 © 2026 Fahi Videos & Aura Agentic AI Cloud。保留所有权利。