# lc-mcp — 基于 AALC 的 Limbus Company MCP server 把 [AhabAssistantLimbusCompany (AALC)](https://github.com/KIYI671/AhabAssistantLimbusCompany) 的识别与操控能力包装成 MCP 工具,给 AI agent(codex / 任意 MCP 客户端)用。 - **低层**:截图、RapidOCR、AALC 模板图匹配(几百张按钮/图标模板)、后台点击/按键,全部直接调 AALC 的 `module.automation` - **高层**:`run_task` 直接跑 AALC 现成的完整流程(日常经验本/纽本、领奖励、狂气换体力、镜牢),自带战斗处理、掉线重试、游戏重启 AALC 以 git submodule 引入(`vendor/aalc`,固定到某个 commit),不改它的代码,升级时只需更新 submodule 指针。 ## 架构 ``` MCP 客户端 ──ssh──> python lc_mcp/bridge.py (stdio, 只用标准库) │ 127.0.0.1:8765, 首行 token 认证 ▼ python -m lc_mcp.server ← 登录时由计划任务在「交互桌面会话」启动 ├─ AalcEngine → AALC auto / ocr / screen (找窗口、后台截图、PostMessage 输入) └─ TaskRunner → 子进程 python -m lc_mcp.aalc_task (停止 = 杀进程树) ``` 为什么要常驻服务 + bridge:SSH 登录的进程跑在 session 0,看不到游戏窗口,也发不了输入。 旧版靠"每次截图注册一个计划任务"绕过,慢且不能输入;现在整个服务常驻在桌面会话里。 ## 部署(Windows,跑游戏的那台机器) ```powershell git clone --recursive https://git.lingll.icu/yws/lc-mcp cd lc-mcp\vendor\aalc uv sync # 按 AALC 的 pyproject 装依赖 (Python >= 3.12),生成 .venv # 先用 AALC 自己的界面 (uv run main.py) 配好队伍、镜牢设置等,lc-mcp 读同一个 config.yaml cd ..\.. powershell -ExecutionPolicy Bypass -File scripts\install_logon_task.ps1 ``` `install_logon_task.ps1` 会注册 `LcMCPServer` 计划任务(登录时启动、普通权限、失败自动重启)。 游戏以管理员身份运行时才需要加 `-Elevated`。卸载:`-Uninstall`。 ## MCP 客户端配置 ```jsonc { "mcpServers": { "limbus": { "type": "stdio", "command": "ssh", "args": ["win", "python", "C:/Users//lc-mcp/lc_mcp/bridge.py"] } } } ``` bridge 读取 `~/lc_mcp/token` 认证(服务首次启动时生成),所以 SSH 用户必须和登录桌面的用户是同一个账号。 服务没起来时 bridge 仍会完成握手,并对每个调用返回“服务未运行”的原因。 本机直接用(客户端本身就在桌面会话里):`python -m lc_mcp.server --stdio`。 ## 工具 | 工具 | 说明 | |------|------| | `get_state` | 截图 + OCR,返回窗口内全部文字 `{text,x,y,w,h,score}` | | `click_text(text, index)` | 按文字点击;忽略空格/大小写,完全匹配优先 | | `wait_for_text` / `wait_for_text_gone` | 轮询 OCR 等文字出现/消失(上限 300s) | | `find_image` / `click_image(name, threshold, model)` | AALC 模板图匹配,适合没有文字的按钮 | | `list_images(prefix)` | 列出模板图,如 `battle/`、`mirror/` | | `screenshot` | 窗口截图(`~/lc_mcp/shots`,只保留最近 30 张) | | `click(x,y,times)` / `keypress` / `type_text` | 低层输入(窗口客户区坐标) | | `run_task(task, …)` | `all` / `daily(exp,thread)` / `reward` / `enkephalin(times)` / `mirror(count)` | | `task_status(lines)` / `stop_task` | 任务状态、日志尾部(`~/lc_mcp/runs`)、强制停止 | 任务运行期间,点击/按键类工具会被拒绝(防止打乱 AALC 的流程),只读工具仍可用。 `run_task` 传入的次数只对本次运行生效,结束后恢复 `config.yaml` 原值。 ## 环境变量 | 变量 | 默认 | 说明 | |------|------|------| | `AALC_DIR` | `vendor/aalc` | 使用其他位置的 AALC 源码 | | `LCP_PORT` | 8765 | 服务/bridge 端口 | | `LCP_KEEP_SHOTS` | 30 | 截图保留张数 | ## 开发 / 测试 ```bash python -m unittest discover -s tests # 不需要 Windows/AALC (FakeEngine) python -m lc_mcp.server --stdio --fake # 假引擎手动调试协议 ``` ## 许可证 AALC 使用 AGPL-3.0。本项目会导入并运行 AALC 的代码,分发时需遵守 AGPL-3.0。