NIMBY Rails Runtime MCP

通过 stdio MCP 调用运行时桥接，在游戏核心命令队列中执行原生操作。使用正常资金，不以屏幕坐标、剪贴板或离线存档编辑作为建设接口。

文档入口

AGENTS.md：项目主文档与索引 维护当前工作约束。详细操作参见：

• 创建一条线路：完整流程

• OSM 数据与线路几何

• 默认参数与接口支持范围

• 候车与 schedules 接口

• 变更记录

默认建设规则为地铁 Medium、按实际地面／高架／地下区间还原；城间高铁 High speed／高架、普速 Medium／Ground。避免造成信号阻塞的跨线平交，普通同层渡线可保留，新站标签为 Name and pax。当前接口固定创建 Medium，High speed 尚待参数化，复杂立交也可能需要扩展层级／坡度接口，详见默认参数文档。

Related MCP server: Roblox Executor MCP Server

启动

仓库位于 D:\Documents\Codes\nimby-runtime-mcp，Python 使用 uv：

uv sync --locked
uv run python server.py

server.py 是 stdio MCP 服务，须由 MCP 客户端连接；不是交互命令行或网络监听服务。首次游戏工具调用才附加唯一游戏进程。先载入目标世界，版本哈希由 game_version.py 检查；当前适配 NIMBY Rails 1.19.10.5bfaea3。

批处理可使用持久客户端，已有会话时复用，不再启动另一份：

uv run python mcp_session.py
# 在另一个终端提交：
uv run python session_call.py runtime_status

文件队列中的请求仍经过标准 MCP call_tool。单连接租约禁止同时附加多个适配器；超时结果先核实再恢复，不自动重放建造或购车。

后台 MCP 进程可以常驻，但原生连接在最后一次请求结束后空闲 30 秒自动安全关闭并释放租约；下一次请求自动附加。正在执行的请求不会被空闲计时器中断；原生 shutdown 无法安全完成时保留连接和租约，稍后重试清理。更新此逻辑后，已启动的旧 Python 服务须正常退出并重启才能生效。

减少模型上下文输出

session_call.py 与 mcp_call.py 默认输出摘要（也可显式 --summary），--full 恢复各入口原有的完整输出格式。Python session_call.call() 的返回与异常行为保持兼容。

uv run python session_call.py runtime_status --summary
uv run python session_call.py get_track_network '{"seed_node_ids":["实际节点ID"],"detail":"summary"}'
uv run python session_call.py runtime_status --full

摘要列出数组数量、少量样本、完整购车 ID、显式 verified=false / isError=true / error / failures 异常及 details_ref。摘要不会自行判定操作验证成功；它不是通用业务审计器。完整协议结果仍保存于持久会话队列；独立 mcp_call.py 的结果保存在系统临时目录。异常详情可能较长，优先保留恢复依据。不要把完整日志再次打印给模型。

get_track_network 支持 detail="summary"（计数、类型／层级分布、建筑层级不一致）、"topology"（移除 curve，保留节点及建筑）、"geometry"（默认，兼容完整返回）。投影在 Python 层完整读取后进行，减少 MCP 返回量，不减少原生读取量。summary 不替代曲线视觉核对、合站或保护对象检查；几何审核使用 geometry。批处理继续通过真实 MCP 完整读回、保存检查点，最后只输出摘要，异常再按 ID 展开。

代码结构

prepare_*、build_line*、configure_line*、verify_line2.py 是特定线路脚本，含固定站序、work/ 路径及历史参数，不是可以直接换名使用的通用生成器。不能重跑旧一号线配置覆盖玩家移除的停站或古城—苹果园改建；其同层渡线也不得作为新地铁模板。

开发检查

uv run python -m unittest discover -s tests -v

新增原生操作还需对应版本的运行时验证。smoke_readonly.py 依赖既有一号线资料并启动独立 MCP 连接，只在前提成立且没有其他附加会话时运行。runtime_probe.py、test_runtime_call.py、test_command_queue.py 是历史调查工具，不是自动回归套件或日常建线入口。

OSM 来源规划保留 OpenStreetMap 归属与许可信息，详见 OSM 文档。世界站数、车队、余额和工程状态以实时读取为准，不以文档历史快照代替。