iflow-mcp_kir4kami_mcp-steamdt

## SteamDT MCP (Python) 一个基于 Python 的 SteamDT 行情 / 数据分析 MCP 服务端，用于让支持 MCP 的大模型（如 Claude 等）可以直接调用 SteamDT 的开放接口，查询饰品行情并做基础分析。 ### 前置要求 - Python 3.10 或更高版本 - 已安装 git（用于方式一安装） - SteamDT API 密钥（在 [SteamDT 官网](https://steamdt.com) 注册后获取） ### 快速开始 #### 最简单的方式（推荐）✨ 1. **直接从 GitHub 安装** ```bash pip install git+https://github.com/Kir4kami/mcp-steamdt.git ``` 2. **在 MCP 客户端中配置** 编辑 Claude Desktop 配置文件（或其他 MCP 客户端），添加： ```json { "mcpServers": { "steamdt": { "command": "python", "args": ["-m", "steamdt_mcp.server"], "env": { "STEAMDT_API_KEY": "你的密钥" } } } } ``` 3. **开始使用** 重启客户端后，就可以在对话中让 AI 查询饰品价格、磨损度等信息了！ > **提示**：`pip install git+...` 会自动下载并安装最新版本，无需手动克隆仓库。 #### 开发模式（需要修改代码） 如果你想修改代码或参与开发，可以克隆仓库后按照 [安装](#安装) 部分的说明进行配置。 > ⚠️ 注意： > - 本项目未内置你的 API 密钥，也不会帮你绕过任何平台限制。请在遵守 SteamDT 官方服务条款的前提下使用。 > - 本项目**只提供数据获取与基础统计功能，不做任何主观推荐或投资建议**；如何解读和使用这些数据，应由上层应用或用户自行决定。 ### 功能概览 #### 基础信息与价格查询 - `get_item_base_info`：获取所有饰品的基础信息（名称、marketHashName 等）。**自动管理本地缓存**，首次调用会请求 API 并保存，后续优先使用缓存，无需担心每天限 1 次的限制。 - `search_item_by_name`：根据中文名或英文名搜索饰品，返回匹配的 `market_hash_name`。特别适合只知道中文名的情况。 - `get_item_price`：根据 `market_hash_name` 查询单个饰品的当前价格信息（每分钟60次）。 - `get_item_prices_batch`：批量查询多个饰品的价格信息（每分钟1次）。 - `get_item_price_history`：查询指定饰品最近若干天的价格历史（30天均价数据）。 #### 磨损度查询 - `get_item_wear_by_inspect_url`：通过检视链接查询饰品的磨损度相关数据（每小时36000次）。 - `get_item_wear_by_asmd`：通过 ASMD 参数查询饰品的磨损度相关数据（每小时36000次）。 #### 价格历史查询 - `get_item_price_history`：查询最近若干天的价格历史数据（30天均价）。根据 `market_hash_name` 和 `days` 参数查询各平台的30天平均价格。 > 所有接口均基于 SteamDT 官方文档实现：`https://doc.steamdt.com/`。权限限制请参考官方文档。 ### 安装 #### 方式一：直接从 GitHub 安装（推荐，最简单）✨ 无需克隆仓库，直接用 pip 从 GitHub 安装： ```bash pip install git+https://github.com/Kir4kami/mcp-steamdt.git ``` 然后在 MCP 客户端配置中使用： ```json { "mcpServers": { "steamdt": { "command": "python", "args": ["-m", "steamdt_mcp.server"], "env": { "STEAMDT_API_KEY": "你的密钥" …