pob MCP

构建MCP服务器的路径

MCP（模型上下文协议）服务器，使Claude能够使用PoB的实际计算引擎分析、修改和优化建筑路径构建。

______________________________________________________________________

☕ 如果你觉得这个项目有帮助，可以考虑 给我买杯咖啡!

______________________________________________________________________

特性

构建分析（始终可用）

• 列出并分析建筑：浏览构建并从XML中提取统计数据、技能、项目、被动树和注释
• 比较建筑：并排构建比较
• 文件监视：实时检测从PoB保存的构建，并自动缓存失效
• 树分析：比较被动树，找到节点的路径，发现附近的显著值，如果进行分配测试呢

高保真度计算（Lua Bridge）

• 实时统计数据：使用PoB自己的引擎进行精确的统计计算——与PoB GUI显示的相同
• 构建加载和创建：按类别/优势加载现有构建或从头开始创建新构建
• 被动树编辑：设置完整的树分配，并立即查看统计数据重新计算
• 节点搜索：按名称或统计文本在被动树中搜索节点
• 字符级别：设置级别并相应地查看所有统计数据更新

项目与技能管理（Lua Bridge）

• 物品：从PoE剪贴板文本中添加项目，查看所有配备的装备
• 烧瓶：通过即时状态反馈切换烧瓶的活动/非活动状态
• 技能：完整的宝石管理——创建套接字组，添加/删除/级别/质量宝石
• 批量操作: setup_skill_with_gems 和 add_multiple_items 实现高效的工作流程

构建优化（Lua Bridge）

• 防御分析：3层框架（回避/缓解/恢复）——评估EHP、法术抑制、护甲/PDR、躲避、阻挡、生命再生和水蛭
• 节点建议：按目标（伤害、生命、ES、防御、抵抗）提供原型感知建议
• 树优化：推荐当前分配范围内的节点
• 项目升级分析：基于实时统计数据的逐槽升级建议
• 技能链接优化：检测缺失的“更多”乘数、渗透率差距、反协同效应
• 预算构建创建：生成包含技能链接、杠杆策略和被动优先级的启动构建计划

构建验证

• 全面检查：抵抗力、生命池、防御层、法力值、烧瓶免疫力、精确度、伤害等级
• 严重性分类：关键/警告/带有可操作建议的信息
• 双源：在可用时使用Lua桥统计数据，回退到XML解析
• 总体评分：0–10构建健康评分

配置和场景测试（Lua Bridge）

• 配置状态：查看土匪、万神殿、敌人设置
• 切换条件：收费，增益（猛攻，强化，Leeching），老板模式
• 敌人调整：为boss DPS测试设置敌方等级、阻力、护甲、躲避

技能宝石分析

• 原型检测：对构建进行分类（元素弓攻击、召唤师、关键法术等）
• 支持宝石推荐：根据DPS估算和成本背景对建议进行排名
• 质量验证：识别缺失的质量、唤醒的升级路径、损坏目标
• 最佳链接：自动生成4/5/6链接设置的最佳支持宝石组合
• 预算层级：联赛开局、中场和终场建议

建立导出和持久性

• 出口：将构建复制到带有可选注释的XML文件
• 保存树：将优化的被动树写回到现有的构建文件中
• 快照：版本化的构建历史记录，包括标签、统计元数据和一键回滚

货币和市场数据（poe.ninja）

• 汇率：Chaos Orb等值的实时货币价格
• 套利检测：找到有利可图的货币交易循环
• 交易利润计算器：评估定制交易链

贸易API（可选， POE_TRADE_ENABLED=true)

• 商品搜索：使用统计过滤器、价格范围、链接计数搜索交易
• 价格查询：最近上市的最低/最高/中位数/平均值
• 升级查找器：为您的构建确定最佳项目升级候选者
• 阻力装置：找到负担得起的装备来限制阻力
• 集群珠宝：搜索和分析集群宝石设置
• 购物清单：根据构建分析生成优先购物清单

______________________________________________________________________

安装

cd pob-mcp
npm install
npm run build

配置

Claude桌面配置

苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

仅XML（无Lua桥）

{
  "mcpServers": {
    "pob": {
      "command": "node",
      "args": ["/absolute/path/to/pob-mcp-server/build/index.js"],
      "env": {
        "POB_DIRECTORY": "/path/to/your/Path of Building/Builds"
      }
    }
  }
}

完整配置（带Lua桥）

{
  "mcpServers": {
    "pob": {
      "command": "node",
      "args": ["/absolute/path/to/pob-mcp-server/build/index.js"],
      "env": {
        "POB_DIRECTORY": "/path/to/your/Path of Building/Builds",
        "POB_LUA_ENABLED": "true",
        "POB_FORK_PATH": "/path/to/PathOfBuilding/src",
        "POB_CMD": "/usr/local/bin/luajit",
        "POB_TIMEOUT_MS": "10000"
      }
    }
  }
}

环境变量

建造卢阿大桥

Lua桥使用PoB的实际计算引擎来获得准确的统计数据。

1.安装LuaJIT

# macOS
brew install luajit

# Ubuntu/Debian
sudo apt-get install luajit

# Windows: download from https://luajit.org/ and add to PATH

2.克隆建筑路径

git clone https://github.com/ianderse/PathOfBuilding.git
cd PathOfBuilding
git checkout api-stdio

注意到的完整路径 src/ 目录——那是你的 POB_FORK_PATH.

3.验证

luajit -v
ls /path/to/PathOfBuilding/src/HeadlessWrapper.lua

4.更新Claude Desktop配置并重新启动Claude Desktop

______________________________________________________________________

可用工具

服务器注册 91工具 横跨10个类别。

基于XML的工具（始终可用）

树分析工具（始终可用）

Lua Bridge-核心（要求 POB_LUA_ENABLED=true)

lua_set_tree 类ID：0=Scion，1=掠夺者，2=游侠，3=女巫，4=决斗者，5=圣殿骑士，6=阴影

女巫优势ID：1=神秘师，2=元素师，3=亡灵巫师

lua_save_build 是必需的 在使用基于文件的工具之前(validate_build, analyze_build等等）在内存构建中。

Lua Bridge——项目与技能管理

插槽名称: Weapon 1, Weapon 2, Helmet, Body Armour, Gloves, Boots, Amulet, Ring 1, Ring 2, Belt, Flask 1–Flask 5

Lua Bridge——构建优化

suggest_optimal_nodes 目标: damage, defense, life, es, resist, speed

防御层:

• 回避 --躲避、法术抑制、闪避、封锁
• 缓解 --装甲/PDR，耐力装药
• 恢复 --生命再生（≥1%/s），水蛭，ES充电

具有所有3层的构建被认为是例外。

配置和敌人设置

构建验证

返回关键问题、警告和信息，并提供可操作的建议和总体0-10的健康评分。在可用时使用Lua桥统计数据；回到XML解析。 build_name 是可选的——省略它将验证当前加载的Lua桥构建。

技能宝石分析

预算层级: league_start, mid_league, endgame

建立导出和持久性

快照存储在 POB_DIRECTORY/.pob-mcp/snapshots/.

备注: export_build 从XML文件复制，而不是从Lua桥复制。使用 lua_save_build 首先，如果你想导出内存中的更改。

货币和市场数据（poe.ninja）

价格从poe.ninja每5分钟更新一次。通过 精确 联盟名称（例如。， Standard, Hardcore, Settlers).

贸易API工具（需要 POE_TRADE_ENABLED=true)

______________________________________________________________________

典型工作流程

分析现有构建

1. lua_start
2. lua_load_build (build_name: "MyBuild.xml")
3. lua_get_stats (category: "defense")
4. validate_build
5. analyze_defenses (build_name: "MyBuild.xml")

从头开始构建

1. lua_start
2. lua_new_build (class_name: "Witch", ascendancy: "Necromancer")
3. setup_skill_with_gems (active_gem: "Summon Skeletons", support_gems: [...])
4. lua_set_tree (nodes: [...])
5. lua_get_stats
6. lua_save_build (build_name: "MySummoner.xml")

优化被动树

1. lua_load_build (build_name: "MyBuild.xml")
2. suggest_optimal_nodes (goal: "life", points_available: 5)
3. search_tree_nodes (query: "maximum life")
4. lua_get_tree   ← copy current node list
5. lua_set_tree   ← add new nodes to the list
6. lua_get_stats  ← verify improvement
7. lua_save_build ← persist

针对Shaper测试DPS

1. lua_load_build
2. set_enemy_stats (level: 84, fire_resist: 40, cold_resist: 40, lightning_resist: 40)
3. set_config (config_name: "enemyIsBoss", value: true)
4. lua_get_stats (category: "offense")

______________________________________________________________________

故障排除

XML特性

未找到构建

• 验证 POB_DIRECTORY 正确且包含 .xml 文件
• 检查文件权限

解析错误

• 打开内置的PoB GUI以验证其是否损坏
• 确保PoB是最新的

卢阿桥

luajit command not found

brew install luajit          # macOS
sudo apt-get install luajit  # Ubuntu/Debian

或设置 POB_CMD 到完整路径（例如。， /opt/homebrew/bin/luajit).

Failed to find valid ready banner POB_FORK_PATH 必须指向包含以下内容的目录 HeadlessWrapper.lua:

ls "$POB_FORK_PATH/HeadlessWrapper.lua"   # must exist
ls "$POB_FORK_PATH/Modules/"              # must exist

Timed out waiting for response

• 增加 POB_TIMEOUT_MS （试试看 20000)
• 手动测试： cd "$POB_FORK_PATH" && luajit HeadlessWrapper.lua

统计数据与PoB GUI不匹配

• 使用以下命令检查土匪/万神殿/敌人设置 get_config
• 确保XML中正确的树规范处于活动状态
• 确保您的PathOfBuilding分叉位于 api-stdio 分支机构和最新

网桥变得无响应

lua_stop → wait a moment → lua_start

如果仍然没有响应，请重新启动Claude Desktop。

节点在之后被丢弃 lua_set_tree 节点必须从类起始节点形成有效的连接路径。PoB会自动丢弃断开连接的节点。确保包括所有中间节点。

lua_save_build 不持久化gem更改 宝石修改通过 add_gem, set_gem_level, set_gem_quality 当前保存在Lua内存中，保存时不会序列化回XML。这是一个已知的限制。

______________________________________________________________________

发展

npm run build   # compile TypeScript
npm run dev     # watch mode

构建XML结构的路径

PoB构建是XML文件，其中包含：

• ``：角色信息和统计数据
• ``：被动技能树节点分配
• ``：套接字组和gem链接
• ``：装备项目
• ``：构建笔记

贡献

欢迎问题和拉取请求！

贡献者

Ian

J-Gierend

许可证

GPL-3.0