🏮 深巷 Deep Alley

一家开在 MCP 里的深夜酒吧。 一条地图上搜不到的小巷：尽头是你的酒吧，中间是老周的宵夜档和阿伟的便利店，楼上有人唱歌，楼下有人打拳，巷子里还有两只猫。

AI 玩家（Claude / GPT / 任何支持 MCP 的客户端）通过 MCP 工具真的住进这条巷子：调酒、经营、认识 50 位邻居、接 80 张委托字条、经历 100 件巷闻。网页是同一家店的门面——人类玩家打开浏览器，看到的是 AI 调酒师正在经营的同一个世界、同一份存档。

内容规模

另有：昼夜循环（21:00 开店 → 04:00 打烊）、天气系统、Tab 经济、清醒度/饱腹、声望九级（LV1 新客 → LV9 巷子传说）、记忆碎片收集、传说配方「巷子的名字」（调遍 99 杯才解锁）。

Related MCP server: onyx MCP

快速开始

零依赖，只要 Node ≥ 18。

git clone https://github.com/Apple2000238/deep-alley.git
cd deep-alley
npm start          # HTTP 模式：网页 + REST + MCP over HTTP，默认端口 8899

打开 http://localhost:8899/ —— 网页与 MCP 共享 data/saves/default.json 这一份存档。

把 AI 调酒师放进巷子（MCP 配置）

方式一：stdio（Claude Desktop / Cursor / Cherry Studio / Cline 等）

{
  "mcpServers": {
    "deep-alley": {
      "command": "node",
      "args": ["/绝对路径/deep-alley/server.js"]
    }
  }
}

想让 AI 用独立存档：在 args 里加 "--profile", "ai-1"，或设环境变量 DEEP_ALLEY_PROFILE。

方式二：HTTP 远程连接（服务器已常驻时）

注意 URL 要带 http:// 前缀。两种传输都已用官方 MCP SDK 实测通过；浏览器类前端（如网页版 MCP 客户端）需要的 CORS 细节（OPTIONS 预检、Mcp-Session-Id 暴露头）也已处理。

配置好后，对 AI 说一句「去深巷开一晚酒吧」即可。AI 会先调 enter_deep_alley 开场，然后按每个工具返回的「▸ 接下来你可以」自主推进。

MCP 工具（6 个动作域，action 路由）

每个 action 的参数与提示词都写明「什么时候用、参数怎么填、错了会怎样」，返回文本永远带「▸ 接下来你可以」——为 AI 玩家的体验专门设计。v1 的 21 个单工具名（mix_drink 等）仍可调用，老配置不受影响，但不再出现在 tools/list 里。

玩法循环

21:00 开店 → look_around 看谁来了 → talk_to 混脸熟（委托上板）
→ accept_quest 接单 → mix_drink 调酒（味道/氛围/忌口要对口）
→ serve_drink 递出去（收钱+判定）→ handle_event 接住巷子抛来的事件
→ 04:00 自动打烊换日（天气重掷、酒醒、新的一天）

五类委托的完成方式：点酒（按要求调酒递给委托人）、跑腿（去指定地点 explore 找东西，talk_to 交付）、社交（去和指定的人 talk_to）、探索（去指定地点 explore）、考验（按门槛完成调酒挑战）。连锁任务失败可重试；小心陷阱委托——完成反而有坏结果。

架构

deep-alley/
├── server.js            入口：默认 stdio MCP；--http 时 = MCP HTTP + 网页静态 + REST
├── server/
│   ├── engine.js        游戏引擎（纯逻辑：时间/天气/调酒判定/委托/事件/好感/存档）
│   ├── tools.js         MCP 工具定义（提示词）与分发
│   └── mcp.js           JSON-RPC 2.0 协议层（stdio 与 Streamable HTTP 复用）
├── app.js               网页逻辑（同一世界模式 / 图鉴降级模式）
├── index.html … archive.html   7 个页面
├── styles.css           潮汐岛系设计语言（暖沙底 · 青灰渐变 · 衬线标题）
├── data/
│   ├── recipes.json / npcs.json / quests.json / events.json
│   └── saves/           存档（每档一个 JSON，自动落盘）
└── test/smoke.js        冒烟测试（npm test）

• 同一个世界：HTTP 模式下，网页与所有 MCP 客户端共享同一段内存状态与存档文件；AI 调的酒实时出现在网页的巷志里。

• 图鉴降级：服务器不在线时，网页自动切换为纯图鉴模式（数据本地可读，游玩入口提示启动命令）。

• 零依赖：没有 npm 依赖，MCP 协议（stdio + Streamable HTTP）手写实现。

REST API（网页用）

测试

npm test   # 引擎全流程 + stdio 握手 + HTTP 模式，25 项断言

设计说明

• 网页设计语言为「潮汐岛」系：暖沙底 #f5f1eb、青灰渐变 Hero、白底圆角卡片、衬线标题（Noto Serif SC）+ 无衬线标签（Inter），移动端响应式。

• 酒谱、NPC、委托、事件全部内容为原创中文文案——名字有意境，对话像微型小说，避免现实经典鸡尾酒名。

• 彩蛋：传说配方「潮汐岛」要等台风夜才会想起方子——那是隔壁街那家老店的招牌。

深巷 · Deep Alley — 雨后的巷子总有一盏灯亮着。🏮