LorAI MCP
hongyue0721/lorAI-mcp
IA jogando Library of Ruina: lê estado, controla combate e navega UI
Ver no GitHubServidor MCP + mod em C# que expõe o estado do jogo Library of Ruina via protocolo MCP, permitindo que agentes de IA leiam saúde, mão de cartas, inimigos e executem ações de combate automaticamente. Integra Python (MCP Server) com C# (mod in-game via HTTP).
Instalação
npx convez-ai hongyue0721/lorAI-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de combate em roguelike de cartas com IA
- Integração de LLM com jogos via MCP e mods
- Prototipagem de agentes autônomos em ambientes de jogo
Veredito

Projeto técnico sofisticado que demonstra MCP em contexto não-trivial (integração jogo + IA). Requer .NET e Python, setup complexo, mas oferece arquitetura bem estruturada para quem quer aprender MCP em produção.
README
A tradução para o português deste README ainda está na fila.
LorAI MCP
让 AI 智能体玩《废墟图书馆》。
通过 MCP 协议将游戏状态、战斗操作、UI 导航全部暴露给 LLM——AI 读血量、看手牌、选情绪卡、出牌打怪,全自动。
AI Agent ←MCP→ Python Server ←HTTP→ C# Mod (in-game)
安装
面向人类用户
复制以下提示并粘贴到你的 LLM 智能体(kimi-code、Claude Code、Cursor 等):
按照以下安装指南安装和配置 LorAI MCP,游戏安装路径是:<填你的游戏路径,例如 D:\steam\steamapps\common\Library Of Ruina> https://raw.githubusercontent.com/hongyue0721/lorAI-mcp/refs/heads/master/docs/guide/installation.md
安装完成后,用 health_check 工具验证 MCP 连通。
面向 LLM 智能体
获取安装指南并按照说明操作。第一步:向用户询问 Library of Ruina 的游戏安装路径。
curl -s https://raw.githubusercontent.com/hongyue0721/lorAI-mcp/refs/heads/master/docs/guide/installation.md
拿到路径后,安装指南中的 <游戏路径> 占位符全部替换为用户提供的路径。
卸载
要移除 LorAI MCP:
按照 https://raw.githubusercontent.com/hongyue0721/lorAI-mcp/refs/heads/master/docs/guide/installation.md 中的「卸载」章节执行卸载步骤。
前置条件
| 依赖 | 说明 |
|---|---|
| Steam | 安装 Library of Ruina (1.1.0.6a13) |
| Python 3.10+ | MCP Server 运行环境 |
| .NET Framework 4.7.2 | C# Mod 编译(需 Developer Pack 或 VS Build Tools) |
| BaseMod | 游戏内 Mod 加载器 |
它能做什么
- 读取游戏状态 — 关卡列表、角色血量、手牌、骰子、buff、敌人信息
- 自动战斗 — AI 决策出牌、推进回合、处理情绪卡选择
- UI 导航 — 选楼层、进邀请、开战、结算、跳剧情
- 静态数据查询 — 卡牌、书籍、敌人、被动能力的完整数据
- 反射调试 — 列出/调用任意游戏方法,深度控制
项目结构
lorAI-mcp/
├── lor_mcp/ # Python MCP Server
│ ├── server.py # FastMCP 入口 + 基础 tools
│ ├── tools.py # Guided tools(战斗自动化)
│ ├── setup.py # MCP 一键注册脚本
│ ├── proxy_server.py # HTTP 代理回退
│ └── config.py # 环境变量配置
├── LorAIHost/ # C# Mod(HTTP bridge + 状态导出 + 战斗自动化)
│ ├── LorAIHostMod.cs # ModInitializer 入口
│ ├── HttpServer.cs # HTTP 服务(端口 17127)
│ ├── StateExporter.cs # 游戏状态导出
│ ├── ActionHandler.cs # Action 分发
│ ├── AdvancedActions.cs # 选书/情绪卡/phase 推进
│ ├── BattleActions.cs # 出牌/确认/结束战斗
│ └── ...
├── docs/guide/installation.md # 安装指南(给智能体读的)
└── pyproject.toml
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
LOR_API_BASE_URL | http://localhost:17127 | 游戏 bridge 地址 |
LOR_PROXY_FALLBACK_URL | http://localhost:17128 | Python 代理回退地址 |
LOR_MCP_TOOL_PROFILE | guided | 工具集(guided 加载战斗自动化) |
LOR_GAME_DATA_DIR | (Steam 默认路径) | 代理服务器的游戏数据目录 |