PoE游戏数据访问服务

PoeMCP

一个MCP服务器，允许任何LLM访问流亡之路游戏数据——宝石、独特物品、被动树节点、物品修改器、地图、圣甲虫、实时定价和建筑之路构建解析。

数据在运行时从以下位置获取 poedb.tw, poe.ninja，以及 poewiki.net。不需要API密钥。

安装

需求

• Claude 桌面版、Claude Code（CLI）或任何其他MCP兼容客户端
• 互联网接入（所有数据在运行时获取）

快速安装（推荐）——无需克隆，无需手动设置

PoeMCP已发布至PyPI poe-buildmcp，所以一个短暂的跑步者 uvx 可以按需获取并运行它，无需克隆或保持更新。将此添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "poemcp": {
      "command": "uvx",
      "args": ["--from", "poe-buildmcp", "poemcp"]
    }
  }
}

• Claude桌面配置位置： macOS ~/Library/Application Support/Claude/claude_desktop_config.json ·窗户 %APPDATA%\Claude\claude_desktop_config.json
• 克劳德代码（CLI）： 将相同的块添加到项目的 .mcp.json --看 mcp.json.example
• 需要 uv 已安装（提供 uvx)；不需要单独安装Python， uvx 管理自己的口译员。

💡 不确定如何配置Claude？ 直接问克劳德： 使用命令将名为PoeMCP的MCP服务器添加到我的配置中 uvx 和args [\"--from\", \"poe-buildmcp\", \"poemcp\"]." Claude将引导您找到配置文件，并为您的操作系统添加正确的JSON块。

手动安装（用于源代码开发/黑客攻击）

⚠️ 需要Python 3.10+ 为了这条路。下载自 python.org 如果你没有。

git clone https://github.com/shalayiding/POEMCP.git
cd POEMCP
pip install -e .

然后将MCP配置指向克隆的副本，而不是 uvx:

macOS/Linux：

{
  "mcpServers": {
    "poemcp": {
      "command": "python",
      "args": ["/path/to/PoeMCP/server.py"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "poemcp": {
      "command": "python",
      "args": ["C:\\path\\to\\PoeMCP\\server.py"]
    }
  }
}

有关分步可视化演练，请参见 安装和输出示例 示例.md.

MCP工具参考

search_gem

按名称或描述关键字搜索流亡之路宝石。

get_gem_detail

获取特定宝石的详细信息。

search_item

按名称、基本类型或mod关键字搜索“流放之路”唯一项目。

get_item_detail

获取特定独特物品的详细信息。

search_passive

按名称或stat关键字搜索被动技能树节点。

get_passive_detail

获取特定被动技能树节点的完整信息。

passive_tree_path

找到从构建当前分配的节点到目标节点的最短被动树路径——反映了构建路径自己的路径算法，因此点成本是精确的，而不是估计的。

search_mods

搜索给定项目类型上可用的项目修饰符（前缀和后缀）。

env_search

按名称或关键字搜索地图和圣甲虫。

env_detail

获取特定地图或圣甲虫的详细信息。

price_check

在poe.ninja中搜索商品或货币的当前价格。

currency_overview

从poe.ninja获取最高货币汇率。

fetch_wiki_page

从poewiki.net页面获取并提取可读内容。

parse_pob

将构建路径共享URL解析为完整的构建摘要。

支持的URL格式：

https://pobb.in/xxxxxxxx
https://pobb.in/u/username/xxxxxxxx
https://pastebin.com/xxxxxxxx

免责声明

这是一个非官方的粉丝项目，与Grinding Gear Games无关或不受其支持。游戏内容（项目名称、技能名称、被动节点等）是Grinding Gear Games的知识产权。数据在运行时从poedb.tw、poe.ninja和poewiki.net获取——此工具仅供个人非商业用途。