Game Narrative

FreeNot checked

通用游戏叙事引擎 MCP，提供一致性校验、动态运行、Meta 伏笔、Playthrough 对比及 Ink/Yarn 导出等功能。

by holycube

GitHub Embed

About

通用游戏叙事引擎 MCP，提供一致性校验、动态运行、Meta 伏笔、Playthrough 对比及 Ink/Yarn 导出等功能。

README

v0.3.1 — 通用游戏叙事引擎 MCP：一致性校验、动态 Run、Meta 伏笔、工作区自发现、Playthrough 对比、角色弧光、Ludo-narrative 检查、Ink/Yarn 导出。

MCP 是「叙事秘书」，不替代游戏运行时。程序与叙事数据分离，支持双工作区布局。

快速开始

git clone <your-repo-url> game-narrative-mcp
cd game-narrative-mcp
npm install
npm run build
npm run setup:cursor   # 生成本机 .cursor/mcp.json

用 Cursor 打开本仓库
Settings → MCP → 刷新，确认 game-narrative 已连接
零基础图文见 配置向导（含游戏总仓口述模板）

验收：在对话中说「请调用 list_projects 和 validate_project 验收 _example」。

CLI

npx game-narrative-mcp validate --project _example
npx game-narrative-mcp export --project _example --adapter game-json-v1
npx game-narrative-mcp export --project _example --adapter ink-v1
npx game-narrative-mcp simulate --project _example --runs 5

文档

文档	说明
配置向导	零基础：一键配 MCP + 游戏仓口述模板
快速开始	安装、验收
架构说明	三层架构、环境变量
双工作区布局	MCP 仓 vs 游戏仓
工作区引导	自发现 + Cursor 模板
Cursor 配置	mcp.json 详解
数据模型	YAML 字段单一事实来源
工具参考	全部 tools + resources
一致性检查	canon vs knowledge
Run 引擎	dynamic vs fixed_depth
节奏板	Beat Sheet 与分析
内容控制	Project Bible
场景清单	Scene Registry
时间线	因果检查
体量估算	字数/VO/key
结局向量	多结局空间
Meta 叙事	跨局伏笔
伏笔生命周期	thread phase 状态机
写作辅助	治「写不出来」
Rog walkthrough	动态 Rog 全流程
固定层 walkthrough	固定层 AVG
与 AI 协作	对话模板
导出适配器	game-json / Ink / Yarn
Playthrough 差异	多结局对比
角色弧光	情感曲线
Ludo-narrative	玩法-叙事冲突
能力预设	capabilities 对照
分支图	强分支 AVG
本地化	文本约束
发布指南	发布检查清单
版本升级	兼容性

示例

projects/_example/ — 迷你 Rog + Meta 线程 + 2 结局
projects/_example_fixed_depth/ — 固定层 AVG

开发

npm run build
npm test

详见 CONTRIBUTING.md。

License

MIT

from github.com/holycube/game-narrative-mcp

Install Game Narrative in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install game-narrative-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add game-narrative-mcp -- npx -y github:holycube/game-narrative-mcp

FAQ

Is Game Narrative MCP free?

Yes, Game Narrative MCP is free — one-click install via Unyly at no cost.

Does Game Narrative need an API key?

No, Game Narrative runs without API keys or environment variables.

Is Game Narrative hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Game Narrative in Claude Desktop, Claude Code or Cursor?

Open Game Narrative on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Game Narrative with

Game NarrativevsGitHub Game NarrativevsFilesystem Game NarrativevsMemory Game NarrativevsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs