Metadata-Version: 2.4
Name: switch-game-mcp
Version: 4.2.0
Summary: Switch游戏折扣与上新查询 MCP Server - 搜游戏、查折扣、查史低价
License: MIT
Project-URL: Homepage, https://gitee.com/kkomia/switch-game-mcp
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=3.0.0

# Switch Game MCP Server

Switch游戏折扣与上新查询 MCP Server，基于 MCP (Model Context Protocol) 协议。

数据来源：[eshop-prices.com](https://eshop-prices.com)（Nintendo eShop 官方各区服价格数据，实时更新）

## 功能

| 工具 | 描述 |
|------|------|
| search_switch_games | 搜Switch游戏，支持中文/英文/日文，自动fallback找最佳匹配 |
| get_game_price_info | 查某个游戏的各区服价格，联网实时汇率换算成目标货币（默认CNY） |
| get_switch_discounts | 看看现在有啥游戏在打折，热门大作优先展示 |
| get_new_switch_games | 最近有啥新出的Switch游戏 |

## 调用示意

AI 模型通过读取工具描述（docstring）自动判断何时调用。以下是各工具的典型触发场景：

| 用户说法 | 自动调用的工具 |
|----------|---------------|
| "塞尔达多少钱" / "Zelda price" / "マリオの値段" | `search_switch_games` → `get_game_price_info` |
| "现在有啥游戏打折" / "Switch discounts" | `get_switch_discounts` |
| "最近出了什么新游戏" / "new Switch games" | `get_new_switch_games` |
| "日服和美服哪个便宜" / "cheapest region" | `get_game_price_info` |
| "宝可梦朱值得买吗" / "is Pokémon good" | `search_switch_games` |

> **💡 给模型的提示**：搜索时中英文皆可，但如果中文搜不到结果，**建议尝试用英文或日文游戏名再次调用**，效果通常更好（因为 eshop-prices.com 对英文/日文的支持更完善）。

## 核心特性

- **中文搜索增强**：中文搜不到时自动访问百度百科提取英文/日文名，再去搜索
- **各区服原价**：`get_game_price_info` 返回各区服原始货币价格，方便比价
- **热门折扣优先**：折扣列表优先展示 Persona、Hogwarts Legacy 等热门大作
- **零硬编码映射**：纯 fallback 架构，不依赖维护繁重的映射表

## 安装

```bash
pip install switch-game-mcp
```

## 启动

```bash
switch-game-mcp
```

或者用 uvx（不用装）：

```bash
uvx switch-game-mcp
```

## MCP客户端配置

```json
{
  "mcpServers": {
    "switch_game_mcp": {
      "command": "uvx",
      "args": ["switch-game-mcp@latest"],
      "env": {}
    }
  }
}
```

## 环境变量

这个服务不需要配任何环境变量，装好直接用。

## 数据说明

本服务使用 [eshop-prices.com](https://eshop-prices.com) 作为数据源，该网站汇总了 Nintendo Switch eShop 各区域（日服、美服、港服、欧服等）的官方价格数据。

## 协议

MIT
