Woven

Woven MCP 连接器

Woven Video 是一款适用于 Mac 的 AI 视频编辑器。导入素材后，通过聊天说明编辑需求，再在真实时间线上进行微调。它是一款功能齐全的编辑器，适用于长视频和短视频，包括 YouTube 视频和 Shorts、播客、游戏视频、Reels、TikToks 等。

这个连接器可让 Mac 上的 AI 应用（例如 Claude Code 和 Codex）在 Woven 中制作和编辑视频。通过它，应用可以：

• 查找 Mac 上的片段并将其导入工作区
• 查看素材
• 制作和编辑 Reels，并检查帧
• 添加字幕
• 生成图像、视频和音频
• 导出

Woven 负责编辑和渲染，并使用你的 Woven 账户和点数。

这是一个本地 MCP 服务：AI 应用会在 Mac 上启动它，并与 Mac 上的 Woven 应用通信。Woven 没有公开的 Web API，因此这个连接器无法在聊天应用或云端和 Web 会话中使用。

要求

• macOS 15 或更高版本。
• Woven 已安装在 /Applications 或 ~/Applications 中。
• 拥有 Woven 账户和套餐，或 3 天免费试用（需要提供银行卡）。请参阅定价。
• 能在 Mac 上运行本地 MCP 服务的 AI 应用。

设置

推荐：粘贴设置提示词

从 woven.video/setup.md 复制适用于你的应用的提示词，并在 Mac 上粘贴到该应用中一次。Woven 的 Settings → AI apps 中也提供相同的提示词。

该提示词会：

1. 检查是否在 Mac 上运行；
2. 仅在你同意后，使用 Homebrew 安装 Woven；
3. 将 Woven 的连接器添加到应用中；
4. 打开 Woven，供你登录。

这种方式不需要此软件包或 Node.js。

手动：使用此软件包

此软件包是一个小型启动器。它会在 Mac 上查找 Woven，并启动应用内置的连接器。npx 需要 Node.js。

1. 安装 Woven。可以下载并将其移至 Applications，也可以运行：

   brew install --cask woven-video/tap/woven
   

2. 打开一次 Woven 并登录。

3. 将连接器添加到你的 AI 应用中。

Claude Code

claude mcp add --scope user woven -- npx -y @woven-video/mcp

Codex

codex mcp add woven -- npx -y @woven-video/mcp

其他应用，例如接受 JSON MCP 配置的 Cursor：

{
  "mcpServers": {
    "woven": {
      "command": "npx",
      "args": ["-y", "@woven-video/mcp"]
    }
  }
}

4. 重启应用或开始新会话，以便加载 Woven 工具。
5. 请它列出你的 Woven 工作区。

你也可以跳过此软件包，让应用直接指向连接器。设置提示词采用的就是这种方式：

• 命令：/Applications/Woven.app/Contents/Resources/woven-sidecar
• 参数：--mcp-stdio

工具

这些工具来自 Woven 应用，因此会随着 Woven 更新而变化。以下列表来自 Woven 0.2.23。

类别	工具
工作区和文件	list_workspaces（从这里开始）、create_workspace、list_files、read_text_file、import_media、download_file、download_video
素材和音频	look_at_media、transcribe_media、extract_audio、identify_song
Reels	list_reels、read_reel、write_reel_spec、render_frame、export_reel、open_in_woven、read_woven_guide、list_sfx_library
字幕	generate_captions、edit_caption_words
生成	list_media_models、generate_image、generate_video、generate_audio、get_generation_status、cancel_generation

除了指南读取器之外，所有工具都需要登录了 Woven 的账户，并拥有套餐或免费试用。

其中有五个工具会消耗 Woven 点数：三个生成工具、字幕工具和转录工具。生成和转录工具会要求你的 AI 应用在首次付费使用前征得你的同意。

启动器的工作方式

bin/woven-mcp 是一个简短的 shell 脚本：

1. 它会先在 /Applications 中查找 Woven.app，然后在 ~/Applications 中查找。
2. 它会运行 Woven.app/Contents/Resources/woven-sidecar --mcp-stdio。

它绝不会向 stdout 写入内容，因为 stdout 承载 MCP 连接。如果未安装 Woven，它会将获取方式打印到 stderr，并以代码 1 退出。脚本本身不会下载任何内容。

故障排除

• **应用的 MCP 日志中显示“Woven isn't installed”：**将 Woven 安装到 /Applications 或 ~/Applications，然后重启应用。
• **工具提示你需要登录或开通套餐：**打开 Woven，登录并开通套餐或试用。
• **设置后没有 Woven 工具：**重启应用或开始新会话。应用会在启动时加载新的 MCP 服务。
• **Woven 版本较旧：**通过菜单栏中的 Woven → Check for Updates… 更新。

链接

• Woven 产品指南
• 什么是视频编辑 MCP 服务？
• 隐私 · 条款 · 联系
• MCP Registry 名称：io.github.woven-video/woven

许可证

LICENSE 中的 MIT 许可证仅适用于此启动器及其打包内容。Woven 应用及其连接器为专有软件，受 Woven 条款约束。