内容
<!-- mcp-name: io.github.gregario/hearthstone-oracle -->
<p align="center">
<a href="https://www.npmjs.com/package/hearthstone-oracle"><img src="https://img.shields.io/npm/v/hearthstone-oracle.svg" alt="npm 版本"></a>
<a href="https://www.npmjs.com/package/hearthstone-oracle"><img src="https://img.shields.io/npm/dm/hearthstone-oracle.svg" alt="npm 下载量"></a>
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node.js 18+"></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple.svg" alt="MCP 兼容"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT 许可证"></a>
<a href="https://github.com/sponsors/gregario"><img src="https://img.shields.io/badge/sponsor-♥-ea4aaa.svg" alt="赞助"></a>
<a href="https://glama.ai/mcp/servers/gregario/hearthstone-oracle"><img src="https://glama.ai/mcp/servers/gregario/hearthstone-oracle/badges/score.svg" alt="hearthstone-oracle MCP 服务器"></a>
</p>
# 炉石先知
炉石 MCP 服务器，提供卡牌搜索、牌组分析及策略指导。使 LLM 可以访问每张炉石卡牌，并提供内置的策略知识，用于牌组构建和游戏建议。
## 功能
- **完整的卡牌数据库** 来自 HearthstoneJSON — 每一张可收藏的卡牌，自动更新
- **牌组解码和分析** — 粘贴牌组代码，获取完整的卡牌列表、法力曲线和原型分析
- **策略知识** — 原型、职业身份、对战动态和游戏概念
- **9 个 MCP 工具** — 搜索、查找、解码、分析、指导
## 快速开始
```bash
claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle
```
卡牌数据在首次运行时自动从 HearthstoneJSON 下载并存储在本地的 `~/.hearthstone-oracle/` 目录中。不需要 API 密钥。
### Claude 桌面版
在您的 Claude 桌面版配置（`~/Library/Application Support/Claude/claude_desktop_config.json`）中添加：
```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` | 每个炉石职业的战略身份 |
| `get_matchup` | 不同原型之间的理论对战动态 |
| `explain_concept` | 解释炉石的基本游戏概念 |
## 工作原理
两层架构：
1. **卡牌数据层** — 来自 HearthstoneJSON 的完整卡牌数据库，存储在本地 SQLite 数据库中，支持 FTS5 全文搜索。卡牌在首次运行时获取，并在有更新的游戏版本时更新。
2. **策略层** — 内置的策略知识，涵盖原型、职业身份、对战理论和核心游戏概念。使服务器能够提供指导和分析，而不仅仅是原始卡牌数据。
## 数据来源
卡牌数据由 [HearthstoneJSON](https://hearthstonejson.com) 提供，由 [HearthSim](https://hearthsim.info) 维护。从游戏文件中自动提取。无限制使用。
## 许可证
MIT
