MCP 集成
StoryLoom 内置 MCP(Model Context Protocol) 能力,作为服务端把你的小说工程与 Story Bible 暴露给外部 AI 客户端(如 Claude Code、Cursor)。让你习惯的 AI 编程/对话工具,能直接读写 StoryLoom 里的创作数据。
这能干什么
MCP 是一套「让 AI 客户端调用本地工具」的标准协议。StoryLoom 作为 MCP 服务端接入后,外部 AI 可以:
- 读取项目、章节正文
- 查询 Story Bible 的角色卡、世界观、时间线
- 在受控范围内辅助创作
于是你可以在自己最顺手的 AI 工具里,调用 StoryLoom 的创作上下文,而不必把设定来回复制粘贴。
形态:stdio sidecar
StoryLoom 随应用打包了一个独立的 MCP 服务端可执行文件(storyloom-mcp,作为 Tauri sidecar 分发)。它以 stdio 方式与 MCP 客户端通信,符合主流客户端的标准接入方式。
┌─────────────────┐ stdio (MCP) ┌──────────────────────┐
│ AI 客户端 │ ◄─────────────► │ storyloom-mcp │
│ (Claude Code / │ JSON-RPC │ (sidecar 服务端) │
│ Cursor 等) │ │ └→ StoryLoom 数据 │
└─────────────────┘ └──────────────────────┘接入方式
在 AI 客户端的 MCP 配置中,把 StoryLoom 的 MCP 服务端登记为一个 stdio server,指向打包的 storyloom-mcp 可执行文件。具体配置项随客户端不同——应用内「设置 → 客户端集成」会给出对应客户端的配置示例。
MCP 能力按阶段演进(P0 已落地,后续逐步扩展可调用的工具集与权限粒度)。最新进展见 路线图。
安全边界
- MCP 服务端只暴露创作相关的数据与操作,不触碰 API Key 等敏感凭据。
- 外部 AI 的调用在受控工具集范围内进行。
