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

> Galgame 不是这样的。

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

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

## 与 skill 版的关系

这是 [galgame_world_engine skill](https://github.com/mchenziyi/galgame-is-not-like-this) 的 MCP 重构版。

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

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

## 安装

```bash
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` 中添加：

```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

```json
{
  "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](https://github.com/mchenziyi/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