poe-data-mcp - Path of Exile game data

poe-data-mcp

本产品与 Grinding Gear Games 没有任何关联，也未获得其认可。

一个 MCP 服务，可让任何大模型访问《Path of Exile》游戏数据，包括技能宝石、传奇物品、天赋树节点、物品词缀、地图、圣甲虫、实时价格，以及 Path of Building 构筑解析。

运行时从 poedb.tw、poe.ninja 和 poewiki.net 获取数据。无需 API 密钥。

poe_mcp_suite 的一部分

此服务是 poe_mcp_suite 的一部分；这是一个面向《Path of Exile》的 MCP 服务集合。该套件适用于任何兼容 MCP 的 AI Agent，并附带一个针对 Claude Code 进行额外优化的分析框架。请参阅套件仓库，了解所有可用服务和工具的概览。

---

安装

要求

• Python 3.10+
• 一个兼容 MCP 的客户端，例如 Claude Desktop / Claude Code、Cursor、Windsurf、Cline、VS Code 或 Zed
• 互联网连接（所有数据均在运行时获取）

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

poe-data-mcp 已发布到 PyPI，因此像 uvx 或 pipx 这样的临时运行器可以按需获取并运行它，无需克隆或持续更新。将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "poe-data-mcp": {
      "command": "uvx",
      "args": ["poe-data-mcp"]
    }
  }
}

Craft of Exile 缓存存储在平台的用户缓存目录中（例如，Windows 上的 %LOCALAPPDATA%\poe-data-mcp\Cache，其他平台上为 ~/.cache/poe-data-mcp）；可通过 POE_DATA_MCP_CACHE_DIR 环境变量更改目录。可选的 fetch_youtube_* 工具使用随附的 yt-dlp。

从源代码安装

**⚠️ 需要 Python 3.10+。**没有它，poe-data-mcp 将无法运行。 如果尚未安装，请从 python.org 下载。

git clone https://github.com/charleslucas/poe-data-mcp.git
cd poe-data-mcp
pip install -e .

之后，你可以通过 poe-data-mcp 命令、python -m poe_data_mcp 或 python server.py 启动它。

💡 不确定如何配置客户端？ 直接询问你的 AI 助手： “请逐步指导我将名为 poe-data-mcp 的本地 MCP 服务添加到 MCP 客户端配置中。命令是 python，参数是我克隆的 poe-data-mcp 文件夹中 server.py 的完整路径。” 它会引导你找到配置文件，并为你的操作系统添加正确的 JSON 配置块。

MCP 配置

下方的 mcpServers 配置块与大多数 MCP 客户端（Claude Desktop/Code、Cursor、Windsurf、Cline、VS Code、Zed……）使用的格式相同，只有配置文件的位置不同。将路径替换为你克隆仓库的目录。分步骤图文指南请参阅 examples.md。

Claude Desktop

文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

macOS / Linux：

{
  "mcpServers": {
    "poe-data-mcp": {
      "command": "python",
      "args": ["/path/to/poe-data-mcp/server.py"]
    }
  }
}

Windows：

{
  "mcpServers": {
    "poe-data-mcp": {
      "command": "python",
      "args": ["C:\\path\\to\\poe-data-mcp\\server.py"]
    }
  }
}

Claude Code（CLI）

将以下内容添加到项目的 .mcp.json 中。模板请参阅 mcp.json.example。

**注意：**请使用 server.py 的完整绝对路径。

---

MCP 工具参考

search_gem

按名称或描述关键词搜索《Path of Exile》技能宝石。

参数	query: str — 用于匹配技能宝石名称和描述的关键词
返回值	匹配技能宝石的列表，包含名称、类型（主动/辅助）、标签和简短描述。采用模糊匹配，最多返回 20 条结果。

---

get_gem_detail

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

参数	gem_name: str — 例如 "Fireball" 或 "Leap Slam"
返回	完整的宝石数据：标签、魔力消耗、施法时间、品质加成，以及一张按等级列出伤害、范围和其他成长数值的表格。

---

search_item

按名称、基底类型或词缀关键词搜索《流放之路》的传奇物品。

参数	query: str — 支持模糊匹配；部分名称、基底类型和词缀文本均可用于搜索
返回	匹配的传奇物品列表，包含名称、基底类型和关键词缀。最多返回 10 条结果。
示例	"headhunter"、"leather belt"、"culling strike"、"life leech dagger"

---

get_item_detail

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

参数	item_name: str — 例如 "Headhunter" 或 "Lifesprig"
返回	完整的物品数据：基底类型、固定词缀、所有显式词缀及其数值范围、风味文本、获取方式（预言卡、商人配方、掉落来源），以及指向 poedb 和 Community Wiki 的链接。

---

search_passive

按名称或属性关键词搜索天赋树节点。

参数	query: str — 用于匹配节点名称和属性的关键词
	type: str (可选) — 按 "keystone"、"notable"、"mastery" 或 "ascendancy" 筛选
返回	匹配的节点列表，包含名称、类型和属性预览。除非按名称直接匹配，否则不包括小型天赋和珠宝插槽。最多返回 20 条结果。

---

get_passive_detail

获取特定天赋树节点的完整信息。

参数	name: str — 例如 "Iron Reflexes" 或 "Divine Shield"
返回	完整的节点属性、精通效果（如适用）、提醒文本、风味文本、升华名称，以及相连节点列表。

---

search_mods

搜索指定物品类型可用的物品词缀（前缀和后缀）。

参数	item_type: str — 要查找的物品类型。例如："helmets str"、"daggers"、"amulets"、"boots dex"、"body armours str int"、"cobalt jewel"
	query: str (可选) — 用于筛选物品词缀的关键词，例如 "life"、"fire resistance"、"attack speed"
返回	按前缀和后缀分组的列表，列出该物品类型可能出现的词缀，包括词缀名称、阶级、物品等级要求和值范围。如果存在腐化固有词缀，也会一并列出。

---

env_search

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

参数	query: str — 用于匹配名称和描述的关键词
	category: str (可选) — "maps" 或 "scarabs"，用于缩小结果范围
返回	匹配的地图列表（含阶级和首领）或圣甲虫列表（含效果文本）。

---

env_detail

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

参数	name: str — 例如 "Strand Map" 或 "Breach Scarab"
返回	**地图：**阶级、首领名称、地形、区域等级、瓦尔区域、相连地图和 Wiki 链接。**圣甲虫：**完整效果文本和堆叠数量。

---

price_check

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

参数	query: str — 要搜索的物品名称
	league: str (可选) — 联盟名称。默认为当前临时联盟（自动检测）。
	category: str (可选) — 用于缩小搜索范围的提示："currency"、"unique"、"gem"、"divcard"、"map" 等。
返回	物品名称、以混沌石和神圣石计价的价格、活跃挂单数量以及查询的联盟。结果缓存 15 分钟。

---

currency_overview

获取 poe.ninja 上的主要货币汇率。

参数	league: str (可选) — 默认为当前临时赛季
返回值	按混沌石价值排名的前 20 种货币物品，显示每种物品对应的混沌石和神圣石价值。结果缓存 15 分钟。

---

fetch_wiki_page

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

参数	wiki_url: str — 完整的 poewiki.net URL，例如 "https://www.poewiki.net/wiki/Headhunter"
返回值	清理后的页面内容，已移除导航和无关信息，同时保留主要文章文本、机制章节和获取信息。适用于深入了解其他工具未涵盖的机制。

---

parse_pob

将 Path of Building 导出代码或分享链接解析为完整的配装摘要。

参数	code_or_url: str — 接受原始 PoB base64 导出代码、pobb.in URL 或 Pastebin URL
返回值	完整的配装摘要，包括：
	• 职业、升华职业、等级
	• 配装说明（作者撰写的指南，已移除颜色代码）
	• 阶段进度 — 每个装备／技能／天赋树配置的阶段标题和节点数量，方便你按步骤跟随配装指南
	• 强盗任务选择和万神殿神祇
	• 关键属性（生命、ES、护甲、闪避、DPS、命中率等）
	• 按插槽分组的所有技能连线
	• 每件已装备物品的完整词缀列表（包括隐性和显性词缀，并标明制作词缀）
	• 天赋树上已分配的核心天赋和显著被动天赋

支持的 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 获取——本工具仅供个人非商业用途。