Goink MCP Server

跟通用 AI 聊天有什么不同

Related MCP server: long-novel-agent-kit

AI 自己查、自己改、自己维护——不是流水线，是 Agent

31 个结构化工具，LLM 自主决策调用哪个、传什么参数、下一步干什么。不是"写完一章传给下一棒"的 pipeline——Agent 在当前对话中调工具查角色、查伏笔、读写正文、更新状态，直到任务完成。

写完一章正文后，系统自动注入维护提醒，告诉 Agent 具体检查什么：角色有没有变化、该回收的伏笔回收了没有、弧线节点需要推进吗、读者认知需要更新吗。Agent 不会"忘了维护"——它被迫逐项自查。

如果还不放心，可以启动审稿子 Agent——一个独立 Agent 从头审读章节内容与系统状态的一致性，发现问题直接写进对话，主 Agent 当场修正。

几十万字里找一句话：本地语义搜索

写到第五十章，要找"主角第一次见到那个吊坠是在哪一章来着？"——不用逐章翻。告诉 AI 一句话，它能在整本书里找到相关段落。

不是关键词匹配，是按意思搜索。你问"关于吊坠的线索"，它能找到那些没写"吊坠"两个字但确实在暗示吊坠存在的段落。Agent 写新章节时也可主动搜索前文，确保持续一致。

整套引擎在本机运行——BGE 中文语义模型 ONNX 本地推理，sqlite-vec 向量索引，MMR 去冗余重排序。写完章节后台自动增量索引，无需网络，无需额外配置。

不只是记忆——是结构化创作状态

角色：关系有历史

角色档案包含性格、能力、背景。角色关系是有向图——"张三对李四是师徒但暗中提防"，"李四对张三是敬重但有所隐瞒"，两条独立记录。关系变化时旧记录保留，可回顾演变过程。

伏笔：不会石沉大海

每条伏笔记录目标回收章节和重要程度。快到回收点系统提醒，超时未回收标记异常。章节计划分三档——下一章、近期、远期——管理创作节奏。

弧线：跨章节叙事线索

弧线由节点链组成，每个节点关联目标章节。写完一章自动推进节点。一个故事通常 3–5 条并行弧线同时追踪。

世界观：地点是图，不是列表

追踪层级包含（王国 → 王宫 → 大殿）和空间连通（A 和 B 由山路连通）。AI 可查详情、子地点、连通关系或完整地图。

读者认知：控制信息释放

追踪读者已知什么、在等什么答案、误认了什么。精确控制悬念和反转时机。

创作偏好：说一次就够

全局偏好和单书偏好两层管理。写到第三十七章，"对话保持冷峻风格"依然生效。

前端可视化状态

Skill 系统：3 层覆盖 × 3 种模式

Skill 是 Goink 的创作方法论模块。每个 Skill 由一个 .md 文件定义，包含 YAML frontmatter 元数据和 markdown 正文。三层覆盖 + 三种模式 = 9 种策略维度，精确控制"什么内容、在什么范围、以什么方式生效"。

三层覆盖

同名 Skill 按 小说 > 用户 > 内置 优先级覆盖。修改即时热重载，无需重启。

三种触发模式

3×3 能力矩阵

新建一个 .md 文件就是新 Skill：

---
name: 我的写作流程
description: 个人定制创作流程
category: 自定义
mode: auto
---
# 正文 markdown 内容

零代码扩展。修改即时生效。删除同理。

风格蒸馏：一段文字 → 一个仿写 Skill

想写出某个作家的笔法？贴一段样文，AI 从六个维度拆解——句式结构、用词习惯、修辞手法、节奏控制、叙事距离、氛围语调——自动生成一个完整的仿写 Skill。不是关键词替换，是提炼风格模式。

生成的 Skill 立刻出现在列表中，/风格名 一键加载，后续所有对话都按此风格输出。也可以打开编辑继续微调。

三重保障，维护不会遗漏

第一层—系统提示词 • Agent 核心指令写死维护流程。"创作完成后立即进行状态维护。不是可选步骤。"

第二层—动态注入 • AI 写完长文后系统自动注入检查项——角色变化、伏笔状态、弧线节点、读者认知。

第三层—审稿 Agent • 独立子 Agent 对比章节与系统状态，发现问题立即反馈。

你的每一次确认

AI 不会直接改正文。每次编辑系统先生成 Diff，等你批准再写入。可以当场批准、拒绝，或者给反馈让 AI 修正。也可以切换到自动模式，连续多轮自由写作。

所有修改都有 Git 历史，任何时候都可以回退到任意状态。

双层沙箱安全隔离——正则白名单只允许 chapters/、outlines/、goink.md 等合法路径，SafePath 杜绝路径穿越。文件编辑写入前重读对比，防止覆盖你的手动修改。

内置 MCP：让 Claude Code / WorkBuddy 直接操作 Goink

Goink 内置 MCP Server（Model Context Protocol），把 30+ 个创作工具暴露给外部 AI Agent。你的 Claude Code、WorkBuddy 等 Agent 使用自己的模型与 API Key，即可在 Goink 的小说数据上调用与内部完全一致的工具——读章节、写正文、管理角色/伏笔/弧线/世界观、本地语义搜索、审稿子 Agent。

# Claude Code（stdio，推荐）
claude mcp add goink -- goink mcp

# 或 HTTP 方式（WorkBuddy 等桌面 Agent）
goink mcp -transport http -addr 127.0.0.1:18344 -token 你的token

也支持桌面端设置页 →「MCP 集成」一键启用（配置端口 / Token / 审批模式）。 详见 docs/mcp.md。

安装

从 Releases 下载对应平台安装包：

• Windows — 运行安装程序

• macOS — 打开 DMG，拖入 Applications

• Linux — 运行 AppImage

需要 LLM API Key（内置 DeepSeek、GLM、MiMo 模板，兼容 OpenAI 格式）。安装包 < 60MB，不需要 Python、Node.js、数据库或 GPU。Windows SmartScreen 可能弹出提示（未签名），点击"更多信息"→"仍要运行"即可。

网络不好？可从网盘下载：https://wwayx.lanzouu.com/b0kp2iyoj 密码：1111

从源码构建

sudo apt install libsqlite3-dev libgtk-3-dev libwebkit2gtk-4.1-dev gcc
git clone https://github.com/sigpanic/goink
cd goink
make deps
make build   # 生产构建
make dev     # 开发模式（热重载）

技术栈

License

Goink is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE for the full text and NOTICE for additional terms under AGPLv3 Section 7.

Star History

赞赏

Goink 开发过程中使用了多种 AI 服务（含订阅费用）。如果 Goink 对你有帮助，欢迎赞赏支持，赞赏将用于覆盖开发过程中的 AI 订阅费用。如果方便，建议备注你的 GitHub 用户名，方便我们记住你的支持。