PoeMCP — Path of Exile game data

Name: PoeMCP — Path of Exile game data
Author: charleslucas

ローカル

github.com/charleslucasゲーム・エンタメ112 週間前に更新

リポジトリ

PoeMCP — Path of Exile game data について

PoeMCPは、Path of Exileのプレイヤーやビルド研究者向けのMCPサーバーです。ゲームデータやWikiの検索、相場の確認、Path of Buildingの解析を実行時のデータ取得で提供します。

主な機能

01ジェムの検索と詳細表示
02ユニークアイテムとモッドの検索
03パッシブノード、マップ、スカラベの参照
04相場と通貨レートの確認
05Wiki取得とPoBビルド解析

活用シーン

01現行リーグでのアイテム価格の比較
02ジェムやパッシブスキルの詳細確認
03マップやスカラベの仕組みの調査
04Path of Buildingのエクスポート内容の要約

MCP 対応

MCPクライアントにPath of Exileのデータ検索とビルド解析のツールを公開します。データはpoedb.tw、poe.ninja、poewiki.netから実行時に取得されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "charleslucas-poemcp": {
      "command": "uvx",
      "args": [
        "poemcp"
      ],
      "env": {
        "POEMCP_CACHE_DIR": "<POEMCP_CACHE_DIR>"
      }
    }
  }
}

起動コマンドuvx poemcp

設定が必要な環境変数

POEMCP_CACHE_DIRDirectory for the Craft of Exile data cache. Defaults to the platform user-cache dir (e.g. %LOCALAPPDATA%/poemcp on Windows, ~/.cache/poemcp elsewhere).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypipoemcp0.1.1stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

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

Markdown 対応

ログインしてコメント

基本情報

作者: charleslucas
言語: python
バージョン: 0.1.1
トランスポート: stdio
掲載日: 2026年7月11日
最終更新: 12 週間前
公式 Registry: io.github.charleslucas/poemcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

PoeMCP — Path of Exile game data

PoeMCP — Path of Exile game data について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

poe-data-mcp

poe_mcp_suite の一部

インストール

要件

クイックインストール（推奨）— クローンも手動設定も不要

ソースからインストール

MCP の設定

Claude Desktop

Claude Code（CLI）

MCP ツールのリファレンス

search_gem

get_gem_detail

search_item

get_item_detail

search_passive

get_passive_detail

search_mods

env_search

env_detail

price_check

currency_overview

fetch_wiki_page

parse_pob

免責事項

コメント