hearthstone-oracle

hearthstone-oracle

カード検索、デッキ分析、戦略コーチングに対応したHearthstone MCP サーバーです。すべてのHearthstoneカードに加え、デッキ構築やゲームプレイのアドバイスに役立つ戦略知識をLLMに提供します。

機能

• 完全なカードデータベース — HearthstoneJSONを基に、収集可能なすべてのカードを収録し、自動更新します
• デッキのデコードと分析 — デッキコードを貼り付けると、カード一覧、マナカーブ、アーキタイプの内訳を取得できます
• 戦略知識 — アーキタイプ、クラスの特性、マッチアップの仕組み、ゲームの概念を網羅します
• 9つのMCPツール — 検索、参照、デコード、分析、コーチング

クイックスタート

claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle

初回起動時にカードデータがHearthstoneJSONから自動でダウンロードされ、~/.hearthstone-oracle/にローカル保存されます。APIキーは不要です。

Claude Desktop

Claude Desktopの設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "hearthstone-oracle": {
      "command": "npx",
      "args": ["-y", "hearthstone-oracle"]
    }
  }
}

ツール

ツール	説明
search_cards	名前、テキスト、クラス、コスト、タイプ、レアリティ、セット、キーワードでカードを検索します
get_card	あいまい検索で特定のカードの詳細情報を取得します
get_keyword	キーワードやメカニクスの定義と、関連カードを確認します
decode_deck	デッキコードをデコードし、マナカーブ付きのカード一覧を取得します
analyze_deck	デッキのアーキタイプ、ゲームプラン、強み、マッチアップ傾向を分析します
get_archetype	デッキのアーキタイプ（アグロ、コントロール、コンボ、ミッドレンジ、テンポ、バリュー）について学べます
get_class_identity	各Hearthstoneクラスの戦略的な特性を確認します
get_matchup	アーキタイプ間の理論上のマッチアップの仕組みを確認します
explain_concept	Hearthstoneの基本的なゲーム概念について解説します

仕組み

2層アーキテクチャです。

1. カードデータ層 — HearthstoneJSONの完全なカードデータベースを、FTS5全文検索機能付きのローカルSQLiteデータベースに保存します。カードは初回起動時に取得され、新しいゲームビルドが利用可能になると更新されます。
2. 戦略層 — アーキタイプ、クラスの特性、マッチアップ理論、ゲームの基本概念を網羅する戦略知識を内蔵しています。これにより、サーバーはカードデータを提供するだけでなく、コーチングや分析も行えます。

データソース

カードデータはHearthSimによるHearthstoneJSONから提供されています。ゲームファイルから自動抽出されており、制限なく利用できます。

ライセンス

MIT