How do I use galgame-mcp-engine?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@galgame-mcp-engine Start a new game" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

galgame-mcp-engine by mchenziyi

# 旮旯给木里不是这样的 — MCP 版

Galgame 不是这样的。

一个视觉小说世界引擎，以 MCP Server 形式运行。任何支持 MCP 协议的 AI 客户端都能驱动它。

谁不想在公司摸鱼的时候来一场甜甜的恋爱呢。

与 skill 版的关系

这是 galgame_world_engine skill 的 MCP 重构版。

	Skill 版	MCP 版
运行方式	Reasonix subagent	独立 MCP Server
格式保证	提示词约束	代码强制
兼容性	仅 Reasonix	所有 MCP 客户端
状态管理	LLM 自觉维护	代码自动维护

MCP 版完全兼容 skill 版的 .game/ 存档，无需迁移。

Related MCP server: MCP Novel Game Server

安装

git clone https://github.com/mchenziyi/galgame-mcp-engine.git
cd galgame-mcp-engine
pip install -e .

依赖：Python 3.12+，DeepSeek API（由客户端调用，MCP Server 自身不调 LLM）。

配置

Reasonix

在项目根目录的 reasonix.toml 中添加：

[[plugins]]
name = "galgame-engine"
command = "python"
args = ["路径/galgame-mcp-engine/src/galgame_engine/server.py"]
env = { GALGAME_DIR = ".game" }

然后将项目根目录的 prompt.md 内容作为系统提示词使用。

重启 Reasonix，输入 /galgame_world_engine 开始。

Claude Desktop

{
  "mcpServers": {
    "galgame-engine": {
      "command": "python",
      "args": ["路径/galgame-mcp-engine/src/galgame_engine/server.py"],
      "env": { "GALGAME_DIR": "路径/你的/.game目录" }
    }
  }
}

Cursor / Windsurf

在 MCP 配置中添加同上的 stdio server 配置。

使用

安装并配置后，在 AI 客户端中调用 MCP tools：

Tool	说明
`galgame_start`	加载存档，返回完整世界上下文（角色/关系/时间线/谜团）
`galgame_action`	提交玩家操作，引擎校验叙事格式并自动维护存档
`galgame_status`	叙事口吻的世界状态摘要

推荐配合项目根目录的 prompt.md 使用——它定义了叙事品质标准、角色规则和决策优先级。适配各客户端的桥接配置见 galgame-is-not-like-this。

架构

prompt.md                   ← 通用叙事 prompt（叙事哲学、品质要求）
         │
         ▼
    AI 客户端（LLM）
         │ 生成叙事
         ▼
┌─────────────────────────────┐
│   galgame-engine (MCP)      │
│                             │
│  server.py      工具入口     │
│  engine.py      核心协调     │
│  state_manager  存档读写     │
│  response_builder 格式校验   │
└─────────────────────────────┘
         │
         ▼
    .game/ (4 个 JSON)

许可证

MIT

Install Server

F

license - not found

A

quality

B

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

galgame-mcp-engine