Skip to content

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 的调用在受控工具集范围内进行。

相关章节

把情节线 + 角色一致性线,编织成一块布