ScreenWeaver

ScreenWeaver MCP 服务

通过 Claude、ChatGPT、Cursor、VS Code 或任意 MCP 客户端，创作剧本和故事板。ScreenWeaver 是一款 AI 电影制作工作室：包含剧本编辑器、与剧本关联的故事板，以及制作画布。此服务可让你的助手直接读取和编辑 ScreenWeaver 项目。

• 远程服务，无需安装： https://app.screenweaver.ai/api/mcp（Streamable HTTP）。
• 登录即可，无需 API 密钥： 此服务使用 OAuth 2.1。登录 ScreenWeaver，选择允许助手打开的项目，然后授权即可。你可以随时在账户的 已连接应用 中撤销授权。
• 22 个工具： 创建项目、导入 Final Draft、WriterDuet 或 Fountain 剧本、对 PDF 或扫描件运行 OCR、编辑场景、将笔记转换为故事板镜头、将漫画或故事板页面切分为分格并将其设为参考。
• 默认安全： 每次编辑或导入剧本时，都会将先前版本保存到历史记录；删除操作需要你明确确认，且没有任何工具会删除项目或故事元素。

各客户端的完整操作指南：screenweaver.ai/mcp。

适用对象

此 MCP 仅供拥有额度的 ScreenWeaver 账户使用，额度包含在 Auteur 和 Studio 套餐中（价格）。读取、编辑和导入剧本均不消耗额度。以下两项操作需要消耗额度：对扫描页面运行 OCR（每页约半个额度）以及查找漫画或故事板页面中的分格（每页约一个额度）。超过 20 页时，助手会在执行前征求你的同意。

连接

Claude（网页、桌面、移动端）： 打开 Settings（设置）、Connectors（连接器）、Add custom connector（添加自定义连接器）。粘贴 https://app.screenweaver.ai/api/mcp，点击 Connect（连接）并登录。

Claude Code：

claude mcp add --transport http screenweaver https://app.screenweaver.ai/api/mcp

然后在 Claude Code 中输入 /mcp，选择 screenweaver，并在浏览器中登录。

ChatGPT： 打开 Settings（设置）、Apps（应用），在高级设置中启用 Developer mode（开发者模式），然后选择 Create（创建）：粘贴 URL 并选择 OAuth。哪些套餐可以添加自定义应用会随时间变化；请参阅 OpenAI 帮助中心。

Cursor（.cursor/mcp.json 或 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "screenweaver": { "url": "https://app.screenweaver.ai/api/mcp" }
  }
}

VS Code（.vscode/mcp.json，在 Agent 模式下通过 Copilot Chat 使用）：

{
  "servers": {
    "screenweaver": { "type": "http", "url": "https://app.screenweaver.ai/api/mcp" }
  }
}

其他客户端： 任何支持通过 Streamable HTTP 和 OAuth 登录连接远程 MCP 服务的客户端。粘贴 URL；客户端会自动找到登录页面。

工具

工具	功能
list_projects	可打开的项目，以及你在各项目中的角色。
list_organisations	你可以在其中创建项目的组织。
get_project_outline	剧集、场景顺序，以及镜头和故事元素的数量。
get_scene	按元素逐一展示一个场景，以及关联的角色和地点。
search_script	包含某个词语或短语的所有台词。
list_entities	角色、地点和物件及其描述。
list_shots	按时间顺序排列的分镜镜头：景别、摄影机、时长和动作。
get_group	制作画布中的一个分组：生成器、提示词、参考资料和图像。
view_media	已导入或生成的图像，或某个镜头的分镜面板。
get_guide	ScreenWeaver 内置指南，帮助助手了解应用的工作方式。
create_project	创建一个空脚本的新电影或剧集项目。
set_project_aspect_ratio	设置项目的画幅比例（16:9、9:16、2.39:1、4:3、3:4）。
import_script	导入 Final Draft、WriterDuet 或 Fountain 文件，并先进行预览供你检查。
extract_file_text	提取 PDF 或页面照片中的文本；扫描件会使用 OCR。
edit_script	插入、更新或删除脚本元素；删除操作需要你确认。
create_shots	按顺序为场景创建镜头，并设置景别、摄影机运动和时长。
update_shot	更新单个镜头的动作、景别、摄影机、时长或衔接方式。
delete_shots	预览后删除你确认要删除的镜头。
create_upload	创建 PDF 或图像的上传位置，文件最大为 25 MB。
import_media	将漫画页、分镜或参考图片作为图像导入，并自动切分画格。
add_reference_images	将图像关联到镜头面板、故事元素或美术指导。
set_prompt	重写生成器的提示词或故事元素的文本。

目前没有工具可以生成图像或视频：助手会准备镜头、提示词和参考资料，由你在应用中运行生成。

请求示例

• “将我贴出的 Fountain 脚本导入我的项目 The Yellow Umbrella。先向我展示预览。”
• “这是我的 PDF 脚本。将其作为剧本导入一个名为 Night Ferry 的新电影项目。”
• “阅读场景 4，并为单机位手持拍摄创建分镜镜头。”
• “导入这一章漫画，将页面切分成画格，并在场景 2 中为每格创建一个镜头。”
• “搜索脚本中每一处提到雨伞的地方，并告诉我哪里漏掉了。”

OAuth 详情（供客户端开发者参考）

• 受保护资源元数据：https://app.screenweaver.ai/.well-known/oauth-protected-resource；授权服务器元数据：https://app.screenweaver.ai/.well-known/oauth-authorization-server。
• 使用 PKCE（S256）的授权码流程、动态客户端注册（RFC 7591）、轮换刷新令牌、令牌撤销（RFC 7009）。
• 未经身份验证的请求会收到 401，并附带 WWW-Authenticate: Bearer resource_metadata="…"。

隐私与支持

ScreenWeaver 会记录调用了哪个工具以及调用时间，但绝不会记录你的提示词或脚本文本。隐私政策：screenweaver.ai/privacy。服务条款：screenweaver.ai/terms。支持邮箱：[email protected]。

许可证

本仓库中的文档采用 MIT 许可证。ScreenWeaver 服务为专有服务，受其服务条款约束。