Chat Editor MCP Server

中文 | English

🌐 在线体验 / Try Online: web-ai-media-editor.cn | web-ai-media-editor.xyz

---

中文说明

🎬 简介

Chat Editor MCP Server 是 Web AI Media Editor 的 MCP (Model Context Protocol) 桥接服务，让你可以在 Kiro 或 Cursor 等 AI IDE 中直接控制视频编辑器。

🔗 编辑器地址：

• 主站：https://web-ai-media-editor.cn
• 备用：https://web-ai-media-editor.xyz

✨ 功能特性

• 🔗 双向通信 - AI IDE 与 Editor 实时同步
• 🎯 完整工具集 - 支持所有编辑操作（添加素材、剪辑、特效、关键帧等）
• 📸 视觉验证 - AI 可截取时间线画面验证效果
• 🔄 状态同步 - 自动将编辑器状态注入 AI 上下文
• 🌐 本地/远程 - 支持本地开发和远程服务器两种模式

🚀 快速开始

方式一：下载安装包（推荐）

1. 访问 web-ai-media-editor.cn
2. 点击顶部 MCP 按钮
3. 下载 MCP Server 安装包
4. 解压后运行 npm install
5. 用 Kiro 或 Cursor 打开解压后的文件夹
6. 打开网页，MCP 会自动连接

方式二：从源码安装

git clone https://github.com/laozuzhen/chat-editor-mcp-server.git
cd chat-editor-mcp-server
npm install

📋 配置

在 .kiro/settings/mcp.json 或 Cursor 的 MCP 配置中添加：

{
  "mcpServers": {
    "editor": {
      "command": "node",
      "args": ["./index.js"],
      "env": {}
    }
  }
}

🛠️ 可用工具

工具	说明
add_element	添加素材/文字/HTML/相机到时间线
edit_clip	移动/裁剪/分割/删除片段
set_clip_property	设置属性或关键帧动画
set_project_config	设置分辨率/帧率/时长
batch_edit	批量操作/涟漪编辑
apply_timeline_edits	一次性应用时间线 JSON
inspect_timeline	查询时间线状态
get_assets	获取素材库列表
analyze_asset	分析素材详细信息
capture_preview	截取时间线画面
capture_asset_frame	截取素材帧/Filmstrip
transcribe_audio	语音转文字
extract_audio	从视频提取音频

🔌 连接模式

本地模式（默认）

Editor 前端 → ws://localhost:9527 → MCP Server → Kiro/Cursor

远程模式

EDITOR_WS_URL=wss://your-domain.com/mcp-ws node index.js

---

English

🎬 Introduction

Chat Editor MCP Server is the MCP (Model Context Protocol) bridge for Web AI Media Editor, enabling you to control the video editor directly from AI IDEs like Kiro or Cursor.

🔗 Editor URLs:

• Main: https://web-ai-media-editor.cn
• Mirror: https://web-ai-media-editor.xyz

✨ Features

• 🔗 Bidirectional Communication - Real-time sync between AI IDE and Editor
• 🎯 Complete Toolset - All editing operations (add assets, cut, effects, keyframes, etc.)
• 📸 Visual Verification - AI can capture timeline frames to verify results
• 🔄 State Sync - Automatically inject editor state into AI context
• 🌐 Local/Remote - Support both local development and remote server modes

🚀 Quick Start

Option 1: Download Package (Recommended)

1. Visit web-ai-media-editor.cn
2. Click the MCP button in the toolbar
3. Download the MCP Server Package
4. Extract and run npm install
5. Open the folder with Kiro or Cursor
6. Open the webpage, MCP will connect automatically

Option 2: Install from Source

git clone https://github.com/laozuzhen/chat-editor-mcp-server.git
cd chat-editor-mcp-server
npm install

📋 Configuration

Add to .kiro/settings/mcp.json or Cursor's MCP config:

{
  "mcpServers": {
    "editor": {
      "command": "node",
      "args": ["./index.js"],
      "env": {}
    }
  }
}

🛠️ Available Tools

Tool	Description
add_element	Add assets/text/HTML/camera to timeline
edit_clip	Move/trim/split/delete clips
set_clip_property	Set properties or keyframe animations
set_project_config	Set resolution/fps/duration
batch_edit	Batch operations/ripple edit
apply_timeline_edits	Apply timeline JSON at once
inspect_timeline	Query timeline state
get_assets	Get asset library list
analyze_asset	Analyze asset details
capture_preview	Capture timeline frames
capture_asset_frame	Capture asset frames/Filmstrip
transcribe_audio	Speech to text
extract_audio	Extract audio from video

🔌 Connection Modes

Local Mode (Default)

Editor Frontend → ws://localhost:9527 → MCP Server → Kiro/Cursor

Remote Mode

EDITOR_WS_URL=wss://your-domain.com/mcp-ws node index.js

---

License

MIT