快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx editly-mcp system_diagnostic

详细介绍

可编辑MCP服务器

⚠️ BETA软件-正在积极开发中 ⚠️ 此程序包当前位于贝塔并处于积极发展之中。虽然功能正常，但您可能会遇到： - 某些系统的安装挑战 - 与某些视频格式的兼容性问题 - 未来版本中的重大变化 - 所有平台组合的有限测试 在生产中使用，风险自负。 我们建议在部署之前在您的环境中进行彻底测试。 🐛 发现问题？ 请报告

🎬 特性

完成视频创作：完全控制剪辑、图层、过渡和效果
简单视频编辑：从文件列表快速创建视频
富格文本叠加：标题、字幕、新闻收报机和动画文本
音频控制：背景音乐、音量混音、音频标准化
高级过渡：剪辑之间有40多种过渡效果
多种图层类型：视频、图像、文本、形状和画布元素
自动依赖处理：Python虚拟环境设置
强大的后备系统：兼容性下降很好

🚀 快速开始

自动安装（推荐）

选择您的平台并运行自动安装程序：

窗户：

# Download and run the installer
curl -O https://raw.githubusercontent.com/moeloubani/editly-mcp/main/install-windows.bat
install-windows.bat

macOS/Linux：

# Download and run the installer
curl -O https://raw.githubusercontent.com/moeloubani/editly-mcp/main/install-unix.sh
chmod +x install-unix.sh
./install-unix.sh

手动安装

如果您更喜欢手动安装或需要更多控制：

npm install -g editly-mcp

先决条件

Node.js 14+ （建议16+，以获得最佳兼容性）
转码已安装并在PATH中可用
Python 3.8+ （安装过程中自动配置）
特定于平台的构建工具 （详见下文要求）

📋 平台特定设置

Windows要求

基本组件：

Visual Studio构建工具2022 （或Visual Studio社区）

- 下载：https://visualstudio.microsoft.com/downloads/ - 包括：“C++构建工具”和“Windows 10/11 SDK”

Python 3.8+ 启用“将Python添加到PATH”

- 下载：https://python.org/downloads/

转码 -多种安装选项：

- 巧克力味: choco install ffmpeg - 温格特: winget install --id=Gyan.FFmpeg - 手册：从下载https://ffmpeg.org/download.html

快速Windows设置：

# Run as Administrator
npm run install-windows

macOS要求

基本组件：

Xcode命令行工具: xcode-select --install
家酿（推荐）：https://brew.sh/
依赖项: brew install python3 ffmpeg node

苹果硅笔记：

确保您使用的是Apple Silicon的原生Node.js
请检查： node -p "process.arch" （应显示“arm64”）
使用Homebrew for Apple Silicon： /opt/homebrew/bin/brew

快速macOS设置：

# Install Xcode Command Line Tools
xcode-select --install

# Install via Homebrew
brew install python3 ffmpeg node

# Install editly-mcp
npm install -g editly-mcp

Linux要求

Ubuntu/Debian：

# Install build tools and libraries
sudo apt-get update
sudo apt-get install -y build-essential pkg-config python3-dev python3-pip
sudo apt-get install -y libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
sudo apt-get install -y ffmpeg nodejs npm

# Install editly-mcp
npm install -g editly-mcp

CentOS/RHEL/Fedora：

# Install build tools and libraries
sudo dnf install -y gcc gcc-c++ make pkg-config python3-devel python3-pip
sudo dnf install -y cairo-devel pango-devel libjpeg-turbo-devel giflib-devel librsvg2-devel
sudo dnf install -y ffmpeg nodejs npm

# Install editly-mcp
npm install -g editly-mcp

Arch Linux：

# Install dependencies
sudo pacman -S --needed base-devel python cairo pango libjpeg-turbo giflib librsvg ffmpeg nodejs npm

# Install editly-mcp
npm install -g editly-mcp

🛠️ 安装故障排除

系统诊断

运行内置诊断工具检查您的系统：

# After installation
npm run diagnose

# Or for detailed help
npx editly-mcp system_diagnostic

常见问题

“未找到FFmpeg”

视窗：确保FFmpeg在您的PATH中或使用 choco install ffmpeg
macOS：通过Homebrew安装： brew install ffmpeg
Linux：通过包管理器安装： sudo apt-get install ffmpeg

“找不到Python”或“缺少distutils”

视窗：在选中“添加到PATH”的情况下重新安装Python
macOS：安装Python 3： brew install python3
Linux：安装Python开发包： sudo apt-get install python3-dev python3-pip

“未找到构建工具”

视窗：安装Visual Studio生成工具
macOS：安装Xcode命令行工具： xcode-select --install
Linux：安装构建必备： sudo apt-get install build-essential

“Cairo/Canvas编译失败”

视窗：确保正确安装了Visual Studio生成工具
macOS：安装Xcode命令行工具
Linux：安装开罗开发库： sudo apt-get install libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev

替代安装方法

如果全局安装失败：

# Try with unsafe-perm flag
npm install -g editly-mcp --unsafe-perm

# Or install locally
npm install editly-mcp
npx editly-mcp

Docker安装（高级）：

# Build Docker image with all dependencies
docker build -t editly-mcp .
docker run -it editly-mcp

🔧 MCP配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "editly": {
      "command": "editly-mcp"
    }
  }
}

Claude桌面配置

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "editly": {
      "command": "editly-mcp"
    }
  }
}

🛠️ 可用工具

`create_video`

创建对各个方面都有完全控制的视频：

{
  "outputPath": "./output/my-video.mp4",
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "audioFilePath": "./audio/background.mp3",
  "keepSourceAudio": true,
  "clips": [
    {
      "duration": 3,
      "layers": [
        {
          "type": "fill-color",
          "color": "#2c3e50"
        },
        {
          "type": "title",
          "text": "My Amazing Video",
          "position": "center",
          "fontSize": 80,
          "fontColor": "#FFFFFF"
        }
      ],
      "transition": {
        "name": "fade",
        "duration": 1
      }
    },
    {
      "duration": 5,
      "layers": [
        {
          "type": "video",
          "path": "./videos/clip1.mp4",
          "resizeMode": "cover"
        },
        {
          "type": "title",
          "text": "Amazing Scene",
          "position": "bottom",
          "fontSize": 48,
          "fontColor": "#FFFFFF"
        }
      ]
    }
  ]
}

`create_simple_video`

从文件列表快速编译视频：

{
  "outputPath": "./output/compilation.mp4",
  "clips": [
    { "path": "./video1.mp4", "duration": 3 },
    { "path": "./video2.mp4", "duration": 4 },
    { "path": "./image1.jpg", "duration": 2 }
  ],
  "audioPath": "./background.mp3",
  "width": 1920,
  "height": 1080
}

`list_transitions`

获取所有可用的过渡效果：

fade, dissolve, circleOpen, crosswarp, dreamyzoom
burn, simplezoom, linearblur, swirl, directional-*
30多个创意过渡

`list_fonts`

获取文本覆盖的可用系统字体。

`system_diagnostic`

运行全面的系统诊断以检查兼容性和依赖性：

// No parameters required
{}

该工具提供：

平台检测和兼容性状态
FFmpeg和Editly可用性检查
构建工具和Python环境状态
平台特定安装建议
详细的故障排除指南

🎨 图层类型

视频层

{
  "type": "video",
  "path": "./video.mp4",
  "resizeMode": "cover", // "contain", "cover", "stretch"
  "cutFrom": 10,         // Start time in seconds
  "cutTo": 20,          // End time in seconds
  "mixVolume": 0.8      // Audio volume (0-1)
}

图像层

{
  "type": "image", 
  "path": "./image.jpg",
  "resizeMode": "cover",
  "zoomDirection": "in", // "in", "out", null
  "zoomAmount": 0.1
}

文字图层

{
  "type": "title",
  "text": "My Title",
  "position": "center",    // "center", "top", "bottom", etc.
  "fontSize": 48,
  "fontColor": "#FFFFFF",
  "fontFamily": "Arial"
}

特殊层

subtitle -底部对齐字幕
news-title -滚动新闻收报机
slide-in-text -动画文本输入
fill-color -纯色背景
canvas -自定义绘图功能

🎵 音频功能

背景音乐：添加带有音量控制的音频文件
源音频：保留或删除原始视频音频
混音：控制不同来源的音量水平
音频标准化：自动水平调节
回路控制：循环播放背景音频以匹配视频长度

⚡ 过渡

超过40种过渡效果可供选择：

基础: fade, dissolve, directional-left/right/up/down

创意: dreamyzoom, burn, crosswarp, morph

几何的: circleOpen, circleClose, cube, rotate

效果: glitchMemories, pixelize, overexposure

🧪 测试与验证

快速测试

安装后，验证一切正常：

# Run system diagnostic
npm run diagnose

# Test basic MCP functionality
npm test

# Test all MCP tools
npm run test-all

手动MCP测试

通过MCP接口测试单个工具：

# Run the MCP server
npx editly-mcp

# In another terminal, test system diagnostic
echo '{"method": "tools/call", "params": {"name": "system_diagnostic", "arguments": {}}}' | npx editly-mcp

🔧 高级故障排除

环境变量

使用环境变量控制行为：

# Skip postinstall checks in CI environments
export SKIP_EDITLY_POSTINSTALL=true

# Force specific Python version
export PYTHON=/usr/bin/python3.9

# Debug mode for detailed logging
export DEBUG=editly-mcp:*

手动依赖关系解决

如果自动设置失败：

# Manual Python virtual environment setup
python3 -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install setuptools wheel

# Manual native dependency installation
npm rebuild

# Clear npm cache
npm cache clean --force

性能优化

为了在资源受限的系统上获得更好的性能：

// Use lower resolution and frame rate
{
  "width": 1280,
  "height": 720,
  "fps": 24
}

// Reduce transition complexity
{
  "transition": {
    "name": "fade",  // Use simple transitions
    "duration": 0.5
  }
}

日志记录和调试信息

启用详细日志记录：

# Enable MCP server debug output
DEBUG=* npx editly-mcp

# Save diagnostic output
npm run diagnose > system-diagnostic.txt

🔄 跨平台兼容性

此软件包旨在跨平台同样良好地工作：

兼容性矩阵

平台	Node.js	FFmpeg	构建工具	状态
macOS（英特尔）	✅	✅	✅	完全支持
macOS（苹果硅）	✅	✅	✅	完全支持
Ubuntu/Debian✅	✅	✅	完全支持
CentOS/RHEL/Fedora✅	✅	✅	完全支持
Arch Linux✅	✅	✅	完全支持
Windows 10/11	✅	⚠️	⚠️	安装程序支持

平台特定注意事项

窗户：

需要Visual Studio生成工具进行本机编译
在某些情况下，FFmpeg需要手动配置PATH
使用自动安装程序： npm run install-windows

macOS：

Apple Silicon需要原生Node.js构建
使用Editly的兼容性分支解决OpenGL问题
建议安装自制啤酒

Linux：

需要开罗发展图书馆
特定于分发的包名称可能会有所不同
最可靠的自动化安装平台

🏗️ 建筑

MCP服务器使用稳健的双策略方法：

主要的，重要的：复杂视频项目的JSON配置
后备方案：保证兼容性的命令行界面

这确保了视频创建始终成功，即使在复杂功能遇到兼容性问题时也是如此。

📁 项目结构

editly-mcp/
├── index.js          # Main MCP server
├── setup-venv.js     # Python environment setup
├── package.json      # Package configuration
├── README.md         # This file
├── LICENSE           # MIT license
└── .npmrc           # NPM configuration

🔌 集成示例

克劳德桌面

创建视频汇编：

“使用渐变和背景音乐从这些剪辑中创建视频剪辑”

API集成

// MCP client call
const result = await mcpClient.call('create_video', {
  outputPath: './my-video.mp4',
  clips: [...],
  audioFilePath: './music.mp3'
});

🤝 贡献

欢迎投稿！请阅读贡献指南，并将pull请求提交到GitHub存储库。

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🙏 致谢

编辑 -强大的视频编辑库
Sailplan编辑叉 -macOS兼容性修复
模型上下文协议 -人工智能集成框架

______________________________________________________________________

由以下材料制成❤️ 靠近莫伊·卢巴尼

目录标签

JavaScriptClaude语音音频视频编辑本地部署MCP服务器多媒体处理自动化视频生成

支持客户端

Claude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Node.js

来源包（packageName，安装包名）

editly-mcp

工具数量（toolCount，工具数）

5

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/f11f1f1acc798fdecedb6ad7b72f5ff5

Editly MCP Server是一个基于Model Context Protocol (MCP)的视频编辑服务器，提供视频剪辑、转场、文本叠加和音频混合等功能。

继续浏览同类 MCP

更多音视频 MCP（1,391）返回 MCP 目录

上一个 MCP

Edge Tts MCP Server Ce660536

一个基于Microsoft Edge TTS的模型上下文协议服务器，支持将文本转换为语音并提供API和MCP服务。

下一个 MCP

Een API MCP

Eagle Eye Networks摄像头系统的模型上下文协议（MCP）服务器，支持AI助手与EEN摄像头交互，查看实时/历史图像，查询事件，管理布局等功能。