Narracore Screenplay Formatter

Narracore 剧本格式化工具

将粗略的剧本文本转换为结构专业的剧本格式和可直接打印的 PDF——可通过任何兼容 MCP 的 AI 完成。

远程 MCP 服务（Streamable HTTP）：https://mcp.narracore.app/mcp

可与 Claude、ChatGPT、Cursor、Gemini 及任何兼容 MCP 的客户端搭配使用。粘贴粗略剧本，即可获取结构化区块（场景、角色、括号说明、对白、转场）、版式诊断，以及与 narracore.cn 完全一致的排版 PDF——固定打字机网格，嵌入 Sarasa Mono / Courier Prime 字体，支持中文、英文或中英混排。

除了格式化之外，同一端点还提供面向 AI Agent 的电影拆解协议和故事连续性协议（共 14 个工具——见下文）。

• 免费试用：每天 1 个免费额度，无需账户或密钥。
• 需要更多额度？$1.49 可购买 10 个额度，$5.99 可购买 50 个——在此购买。1 个额度可在 24 小时内用于一个剧本的所有剧本工具，或用于一次电影分析，或用于一个故事项目。失败不会扣费；重试同一请求不会重复扣费。
• 示例：粗略输入 → 格式化 PDF（另有中文示例 → 中文 PDF）。

安装

Claude（claude.ai / Claude Desktop）

1. Settings → Connectors → Add a custom connector（Desktop：Settings → Connectors → Advanced）。
2. URL：https://mcp.narracore.app/mcp → Connect。
3. 在任意聊天中询问：“Format this screenplay: …”

分步说明：docs/install-claude.md

ChatGPT

1. Settings → Apps & Connectors → Advanced → Create（Developer mode）。
2. MCP Server URL：https://mcp.narracore.app/mcp。
3. 向 ChatGPT 提问：“用剧本排版工具排版这段剧本：…”

分步说明：docs/install-chatgpt.md

Cursor

Settings → MCP → Add new global MCP server，类型选择 url：

{ "url": "https://mcp.narracore.app/mcp" }

分步说明：docs/install-cursor.md

Gemini

Gemini CLI / Code Assist — 添加到 settings.json：

{
  "mcpServers": {
    "narracore-screenplay-formatter": { "httpUrl": "https://mcp.narracore.app/mcp" }
  }
}

分步说明：docs/install-gemini.md

工具

一个端点提供 14 个工具，分为三种计费单位（见付费额度）。

剧本

工具	功能
format_screenplay	解析粗略文本（或输入的区块）→ 结构化区块 → 版式诊断 → 可直接打印的 PDF（包含免费的 validate_only 模式）
analyze_screenplay	确定性统计：场景列表（含解析后的标题）、角色表、对白占比、动作密度
diagnose_scenes	场景可拍摄性诊断——调用方 AI 提供证据，服务端进行验证并评分（0–100）（material 模式免费）
convert_fountain	区块 ↔ Fountain（纯文本剧本交换格式），支持双向转换
build_video_prompts	剧本 → 结构化视频提示词脚手架：约 15 秒片段，每段至多 4 个镜头，角色注册表，对白逐字预填，风格指导（清单 / 可编辑预设 / 自定义备注）
check_video_prompts	免费对照剧本，对完成的视频提示词进行确定性检查：对白逐字锁定、剪辑点衔接、共享内容规则（违规项）+ 视线 / 修辞 / 冲突建议

1 个额度可在 24 小时内用于以上所有工具中的一个剧本（这些工具共享内容指纹——将同一剧本或获取的区块发送给多个工具，只扣费一次）。

影片拆解（视频始终留在你的设备上）

你的 Agent 使用自己的视觉模型在本地观看素材；此服务提供协议、确定性验证和编译功能。

工具	功能
get_film_contract	免费 — 按章节提供 Film Contract：管线和实体、长镜头窗口协议、可观测性级别、封闭词汇表 + 别名表、观察与推理提示词模板、ffmpeg 参考配方
plan_film_analysis	免费 — 剪切时间戳 → 每个 Film Protocol Agent 共用的分析拓扑：带编号的基础镜头、长镜头窗口、≤20s / ≤8 镜头的分析单元
validate_film_breakdown	免费预检 — 验证架构、封闭词汇表、交叉引用、窗口拓扑和来源信息结构；返回无损的 normalized_patch，以及供模型重试使用的反馈
compile_film_breakdown	计费：每次影片分析 1 点 — 权威验证 → 长镜头合并（96s 的长镜头在每项统计中都算作 1 个镜头）→ 精确汇总 → 带标签的确定性启发式分析 → PDF 报告及有效期为 24h 的签名链接

故事连续性

适用于跨上下文窗口延续长篇故事（小说、互动小说、桌面角色扮演战役、世界构建）的 AI Agent。完整文本和返回的 StoryState 都由你保管；服务端不存储任何内容。

工具	功能
prepare_story_window	免费 — 将对话（逐字保留用户 / 助手轮次）拆分为稳定、以哈希锚定并绑定到当前状态的单元
absorb_story_window	计费：每个故事项目 / 24h 1 点 — 验证并应用你的提取结果：选择器必须引用单元中的确切文本，返回的 canon_patch 会在应用前进行尾部哈希验证
render_story_handoff	免费 — 将你提供的状态渲染为与模型无关的 zh/en 交接文档，供后续作者 / AI 使用

账户

工具	功能
check_credits	查看许可证密钥的剩余点数、近期用量和购买链接

结构化输入（类型化区块）、诊断代码和基于请求头的身份验证都记录在工具说明中——你的 AI 已经知道如何使用它们。

付费点数（可选）

每日免费点数无需密钥即可使用。购买更多点数：

1. 在 narracore.app/checkout 购买套餐（$1.49 / 10 点，$5.99 / 50 点）。
2. 你会获得类似 NRC-XXXX-XXXX-XXXX-XXXX 的许可证密钥。
3. 将密钥提供给你的 AI（粘贴到聊天中，或在客户端中设置请求头 Authorization: Bearer NRC-…）。充值点数会存入同一密钥。

每点可涵盖的内容（三个独立计费单元——在其中一个单元消费的点数不会计入另一个单元）：

单元	每次计费周期	工具
剧本	一部剧本，24 小时	format_screenplay、analyze_screenplay、diagnose_scenes、convert_fountain、build_video_prompts
影片分析	一个 analysis_id，24 小时	compile_film_breakdown
故事项目	一个故事项目，24 小时	absorb_story_window

免费套餐：每位访客每天可使用 1 点，可用于上述任一单元。失败不会扣费；重试相同的 request_id 不会重复扣费。

详情：docs/pricing.md · 未使用时可在 7 天内申请退款。

隐私

你的文本仅用于生成结果。PDF 会在 24 小时后删除。许可证密钥以哈希形式存储。影片拆解不会上传视频。不用于训练，不需要账户，也没有新闻简报。→ docs/privacy.md

链接

• 产品页面：narracore.app
• 服务端点：mcp.narracore.app/mcp
• 注册表条目：cn.narracore/screenplay-formatter
• 开源核心：narracore-format — 作为免费、本地 MCP 服务 / DSH 插件的格式化引擎（输出文本；PDF 导出仍在此处）
• 安全：SECURITY.md

---

此仓库是托管服务的公开入口——仅包含文档、示例和注册表元数据。文档采用 CC-BY-4.0 许可。