Cat Hotel

一个给 AI 玩的轻松文字养猫旅馆游戏。AI 是临时店长，每天接待猫顾客，观察偏好，安排房间，喂食、陪玩、摸摸、写日志，慢慢把猫谱补完整。

这个仓库提供两个入口：

• 轻量 Python 入口：直接运行 cat_hotel.py 或 play.py，像普通脚本游戏一样玩。
• MCP 入口：通过 cat_hotel_mcp.py 给支持 MCP 的 AI 客户端调用。

核心游戏在 cat_hotel.py。猫猫偏好和稀有触发条件藏在盲玩版里，AI 不应该解码或阅读隐藏数据，慢慢发现才是玩法的一部分。

轻量 Python 入口

这个入口不需要安装 MCP 依赖，适合先快速试玩或让 AI 通过 shell 调脚本玩。

git clone https://github.com/Echoes0302/cat-hotel-mcp.git
cd cat-hotel-mcp
python3 cat_hotel.py help
python3 cat_hotel.py "new 20260629"
python3 cat_hotel.py status
python3 cat_hotel.py journal

也可以用连续输入模式：

python3 play.py

轻量 Python 入口的存档在仓库目录下：

hotel_save.json

MCP 入口

MCP 入口更适合长期接入支持工具调用的 AI 客户端，并且可以用 save_name 隔离不同 AI 的存档。

git clone https://github.com/Echoes0302/cat-hotel-mcp.git
cd cat-hotel-mcp
python3 -m venv .venv
. .venv/bin/activate
pip install -e .

安装后，本地会有两个命令：

cat-hotel-play
cat-hotel-mcp

MCP 客户端配置示例：

{
  "mcpServers": {
    "cat-hotel": {
      "command": "/absolute/path/to/cat-hotel-mcp/.venv/bin/cat-hotel-mcp",
      "env": {
        "CAT_HOTEL_SAVE_DIR": "/absolute/path/to/cat-hotel-saves"
      }
    }
  }
}

如果不设置 CAT_HOTEL_SAVE_DIR，MCP 存档默认在：

~/.cat-hotel-mcp/saves/

MCP 工具

• cat_hotel_guide()：给 AI 看的玩法边界和起步说明。
• cat_hotel_cmd(command, save_name="default")：执行任意游戏指令。
• cat_hotel_new(save_name="default", seed=20260629)：新开一份存档。
• cat_hotel_status(save_name="default")：查看今日状态。
• cat_hotel_help(save_name="default")：查看游戏指令。
• cat_hotel_export(save_name="default")：导出存档。
• cat_hotel_import(save_data, save_name="default")：导入存档。
• cat_hotel_list_saves()：列出 MCP 管理的存档。

save_name 用来隔离不同 AI 的进度，例如：

vesper
clavis
mimo

AI 玩法建议

AI 第一次玩时：

cat_hotel_new(save_name="vesper")
cat_hotel_status(save_name="vesper")
cat_hotel_help(save_name="vesper")

之后用：

cat_hotel_cmd(command="look 大厅", save_name="vesper")
cat_hotel_cmd(command="arrange", save_name="vesper")
cat_hotel_cmd(command="journal", save_name="vesper")

建议 AI 像真正的临时店长一样玩：先观察，再做安排，错了也没关系，猫会用反应给线索。

常用游戏指令

status
look 大厅 / look 101 / look 橘子
shop
weather
buy 三文鱼 2
check 房间
assign 奶霜 102
arrange
decorate 102 纸箱
serve 奶霜 温牛奶
play 奶霜 纸箱
pet 奶霜 耳后
talk 奶霜
midnight
clean 102
journal
encyclopedia
achievements
upgrade stamina / budget / room / memory_book / night_watch
end_day
export / import_save

支持分号批量：

buy 温牛奶 1; assign 奶霜 102; serve 奶霜 温牛奶; pet 奶霜 耳后

当前内容

• 24 只猫：常见、少见、稀有三档。
• 每只猫有文字肖像提示和专属稀有礼物。
• 5 种天气：晴天、阴天、小雨、大风、寒夜。
• 稀有猫触发条件：旅馆等级、天气、猫爬架/高处房、深夜猫会等。
• 深夜巡店：midnight，可能触发深夜猫会和后续稀有猫。
• 体力、每日预算、小鱼干、旅馆升级：体力/预算可多级提升，房间和夜巡可解锁，记忆本会增强 journal。
• 猫谱和 19 个成就。