poe-data-mcp - Path of Exile game data

poe-data-mcp

この製品は、Grinding Gear Games とは一切関係がなく、同社からの推奨も受けていません。

あらゆる LLM から Path of Exile のゲームデータ（ジェム、ユニークアイテム、パッシブツリーのノード、アイテム修飾詞、マップ、スカラベ、リアルタイム価格、Path of Building のビルド解析）にアクセスできるようにする MCP サーバーです。

データは実行時に poedb.tw、poe.ninja、poewiki.net から取得されます。API キーは不要です。

poe_mcp_suite の一部

このサーバーは、Path of Exile 向け MCP サーバーのコレクションである poe_mcp_suite の一部です。このスイートは、あらゆる MCP 互換 AI エージェントで動作し、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 フォルダー内の server.py のフルパスを引数に指定し、コマンドを python として、poe-data-mcp というローカル MCP サーバーを MCP クライアント設定に追加する手順を、段階を追って案内してください。」 設定ファイルの場所を探す方法や、お使いの OS に適した 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

特定のジェムの詳細情報を取得します。

Parameters	gem_name: str — 例："Fireball" または "Leap Slam"
Returns	ジェムの全ステータス：タグ、マナコスト、詠唱時間、品質ボーナス、およびダメージ、範囲、その他のスケーリング値をレベルごとに示した表。

---

search_item

名前、ベースタイプ、またはモッドのキーワードでPath of Exileのユニークアイテムを検索します。

Parameters	query: str — あいまい検索に対応しています。部分的な名前、ベースタイプ、モッドのテキストで検索できます
Returns	一致したユニークアイテムのリスト。名前、ベースタイプ、主要なモッドが含まれます。最大10件。
Examples	"headhunter", "leather belt", "culling strike", "life leech dagger"

---

get_item_detail

特定のユニークアイテムの詳細情報を取得します。

Parameters	item_name: str — 例："Headhunter" または "Lifesprig"
Returns	アイテムの全データ：ベースタイプ、暗黙のモッド、値の範囲を含むすべての明示的なモッド、フレーバーテキスト、入手方法（占いカード、ベンダーレシピ、ドロップ元）、およびpoedbとCommunity Wikiへのリンク。

---

search_passive

名前またはステータスのキーワードでパッシブスキルツリーのノードを検索します。

Parameters	query: str — ノード名とステータスに一致させるキーワード
	type: str (optional) — "keystone"、"notable"、"mastery"、または "ascendancy" で絞り込み
Returns	一致したノードのリスト。名前、タイプ、ステータスのプレビューが含まれます。名前が直接一致しない限り、小型パッシブとジュエルソケットは除外されます。最大20件。

---

get_passive_detail

特定のパッシブスキルツリーノードの全情報を取得します。

Parameters	name: str — 例："Iron Reflexes" または "Divine Shield"
Returns	ノードの全ステータス、マスタリー効果（該当する場合）、リマインダーテキスト、フレーバーテキスト、アセンダンシー名、および接続されたノードのリスト。

---

search_mods

指定したアイテムタイプで使用可能なアイテムモッド（prefix と suffix）を検索します。

Parameters	item_type: str — 検索するアイテムタイプです。例："helmets str"、"daggers"、"amulets"、"boots dex"、"body armours str int"、"cobalt jewel"
	query: str (optional) — モッドを絞り込むキーワードです。例："life"、"fire resistance"、"attack speed"
Returns	そのアイテムタイプに付与される prefix と suffix のグループ一覧です。モッド名、ティア、必要アイテムレベル、数値の範囲が含まれます。存在する場合は、汚染された暗黙モッドも含まれます。

---

env_search

名前またはキーワードでマップとスカラベを検索します。

Parameters	query: str — 名前と説明に一致するキーワードです
	category: str (optional) — 結果を絞り込む場合は "maps" または "scarabs" を指定します
Returns	一致するマップ（ティアとボスを含む）またはスカラベ（効果テキストを含む）の一覧です。

---

env_detail

特定のマップまたはスカラベの詳細情報を取得します。

Parameters	name: str — 例："Strand Map" または "Breach Scarab"
Returns	マップ： ティア、ボス名、タイルセット、エリアレベル、ヴァールエリア、接続先マップ、Wiki リンクです。スカラベ： 効果テキスト全体とスタックサイズです。

---

price_check

poe.ninja でアイテムまたは通貨の現在の価格を検索します。

Parameters	query: str — 検索するアイテム名です
	league: str (optional) — リーグ名です。デフォルトは現在のテンポラリーリーグ（自動検出）です。
	category: str (optional) — 検索を絞り込むためのヒントです："currency"、"unique"、"gem"、"divcard"、"map" など
Returns	アイテム名、カオスオーブとディヴァインオーブでの価格、有効な出品数、検索対象のリーグです。結果は 15 分間キャッシュされます。

---

currency_overview

poe.ninja から主要な通貨の交換レートを取得します。

パラメーター	league: str (optional) — 省略した場合、現在の一時リーグが使用されます
戻り値	カオス価値順にランク付けされた上位20種類の通貨アイテム。各アイテムのカオス換算額とディバイン換算額を表示します。結果は15分間キャッシュされます。

---

fetch_wiki_page

poewiki.net のページを取得し、読みやすいコンテンツを抽出します。

パラメーター	wiki_url: str — poewiki.net の完全なURL。例："https://www.poewiki.net/wiki/Headhunter"
戻り値	ナビゲーションと不要な要素を取り除いたページコンテンツ。記事本文、メカニクスのセクション、入手方法に関する情報は保持されます。他のツールでは扱われていないメカニクスを詳しく調べるのに便利です。

---

parse_pob

Path of Building のエクスポートコードまたは共有URLを解析し、ビルドの概要をすべて表示します。

パラメーター	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 から取得されます。このツールは個人的かつ非商用の利用に限られます。