About Scriptmate
Scriptmate is an MCP server published by zhangyiling108-code in the Finance category: scriptMate MCP：文案驱动的真实图片与视频素材匹配，支持独立 MCP / CLI、配置向导和素材审核包。.
The repository has 5 stars and 0 forks, with the last commit 9 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/zhangyiling108-code/scriptmateThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Scriptmate
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
Releases
README
ScriptMate MCP · 文案驱动的真实素材匹配
安装与配置教程 · 下载发布包 · CLI 中文说明 · English
把短视频文案变成可审核的素材方案包：文案分段 → 视觉策略 → 搜索真实图片/视频 → 评分与主选/备选 → 审核页和来源链接。
ScriptMate 提供独立的本地 MCP 服务和 CLI，适用于科普、行业分析、讲解视频的前期素材准备。支持本地 stdio MCP 的客户端可以发现并调用它，无需特定 Agent、Skill 或提示词。使用者提供自己的模型/素材源密钥，配置、缓存和产物保存在自己的电脑上。
快速开始
1. 安装
先按 uv 官方安装说明 安装 uv，再执行以下命令。macOS、Linux 和 Windows PowerShell 均可使用；uv 会准备 Python 3.11 和隔离的依赖环境：
uv tool install --python 3.11 "copy-material-matcher[mcp] @ https://github.com/zhangyiling108-code/scriptmate/releases/download/v0.2.1/copy_material_matcher-0.2.1-py3-none-any.whl"
若提示 scriptmate 不在 PATH，执行 uv tool update-shell，然后重新打开终端。
2. 配置
scriptmate setup-mcp
向导会让你选择完整匹配或仅搜索公开素材，隐藏输入 API Key，配置规划/评分模型、图片核验与素材源，然后自动生成：
config.toml：本机私有配置；POSIX 系统文件权限为 600。mcp-client.json：可供通用 MCP 客户端使用的真实命令与绝对路径。mcp-codex.toml：Codex 的 TOML 配置片段。- 可直接复制执行的 Codex / Claude Code 添加命令。
默认文件位于 ~/.config/scriptmate/。接入文件不含密钥；已有配置默认保留。需要修改时运行 scriptmate setup-mcp --reconfigure，向导会先保存私有备份。
3. 检查并接入
scriptmate check-mcp
看到 “MCP 连接成功：发现 6 个工具”，表示服务能启动、配置能读取、协议连接正常。这一步不调用模型或素材源 API，也不会消耗其额度。
随后执行向导生成的添加命令，或在客户端的 MCP 设置中填写 mcp-client.json 里的 command 和 args，重新连接后即可使用。详细客户端接入步骤
4. 第一次使用
可以先对 AI 客户端说：
使用 ScriptMate 检查配置，再从 NASA 搜索 3 张 space mission 的 16:9 图片，保留来源链接。
完整匹配示例：
使用 ScriptMate 为下面的文案匹配素材，比例 9:16，1080，每段 3 个候选。保留真实来源，不下载、不降级。开始后等待任务完成，再给我审核页路径和未匹配段落。
把文案接在后面即可。完整匹配先返回任务 ID，再通过 get_result 查询进度和分页结果，不需要重复启动任务。
需要什么
| 使用方式 | 需要准备 |
|---|---|
| 仅搜索 NASA / Wikimedia Commons 公开素材 | 本地 stdio MCP 客户端与网络，无需模型密钥 |
| 文案分段、完整素材匹配 | 自己的规划/评分模型 API 密钥和额度 |
| 通用 B-roll 搜索 | 可选 Pexels、Pixabay、Coverr 的素材源密钥 |
| 实际图片核验 | 支持图片输入的评分模型，并在向导中明确启用 |
MCP 是调用入口。配置中的模型 API 费用与聊天客户端的订阅额度分别计算。NASA / Commons 的题材范围有限；具体国家、主体、动作与比较关系仍需要审核。
得到什么
analysis.json、manifest.json、review.html、summary.md、segments_overview.csv、attributions.md 和 segments/<id>/segment.json。可在本机浏览器打开审核页，查看主选、备选、评分细项、来源与许可。
默认链接优先，不下载完整素材；所有降级默认关闭。没有达到质量门槛的主选保留人工复核状态。视频目前只核对封面，完整动作、可剪辑片段和最终授权仍需人工核对。
MCP 工具
| 工具 | 作用 |
|---|---|
doctor |
配置就绪、模型/素材源和核验范围；不显示密钥 |
analyze_script |
分段和视觉/搜索策略 |
search_materials |
单次真实素材搜索 |
match_script |
启动完整匹配，返回任务 ID |
get_result |
进度、摘要、分页候选和文件路径 |
cancel_match |
取消任务并保留已有文件 |
其他安装方式与维护
开发验证使用 python -m pip install '.[mcp,dev]' 和 python -m pytest tests -q。基础 CLI 支持 Python 3.9+；MCP 支持 Python 3.10+。测试不消耗真实模型额度，真实账户与素材质量需要分别验证。
README fetched from the repository 5 hours ago. The original is authoritative.