@xiawan-play/steam-tools-mcp

一个面向 Node.js 的 Steam MCP 服务，聚焦中文用户常用的高频场景：资料、游戏库、单游戏快照、成就、新闻和应用解析。

特性

• 只保留高频事实型工具，不暴露底层原始 API explorer；攻略类工具只整合官方成就和 Steam 指南中的可追溯事实。
• steam_get_* 负责通用查询和公共事实视图，steam_me_* 负责默认账号主入口、专项视图和快捷入口。
• 单游戏工具统一支持 appid 或 query，可直接输入中文游戏名。
• 返回结构尽量统一为 target / summary / items / sections / warnings，更适合模型消费。

快速开始

直接作为 MCP 运行

npx -y @xiawan-play/steam-tools-mcp

如需读取用户数据

读取资料、游戏库、成就、好友等用户数据通常需要 STEAM_WEB_API_KEY；长期使用 steam_me_* 时建议同时配置 STEAM_DEFAULT_STEAMID。

$env:STEAM_WEB_API_KEY="YOUR_WEB_API_KEY"
$env:STEAM_DEFAULT_STEAMID="YOUR_STEAM_ID64"
$env:PROXY_URL="http://YOUR_PROXY_HOST:PORT"

本地开发

npm install
npm run sync:steam-spec
npm run build
npm run check:tool-registry
npm run dev

MCP 配置

推荐配置

{
  "mcpServers": {
    "steam-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@xiawan-play/steam-tools-mcp"
      ],
      "env": {
        "STEAM_WEB_API_KEY": "YOUR_WEB_API_KEY",
        "STEAM_DEFAULT_STEAMID": "YOUR_STEAM_ID64",
        "PROXY_URL": "http://YOUR_PROXY_HOST:PORT"
      }
    }
  }
}

常用环境变量

其他可选环境变量

完整参数说明见 docs/configuration.md。

工具总览

公共主入口

公共专项视图

目标解析与候选

默认账号主入口

默认账号专项视图

默认账号快捷入口

使用说明

• 大多数用户数据场景都需要 STEAM_WEB_API_KEY，公开新闻和在线人数这类接口通常可以直接查。
• steam_search_apps 和 steam_resolve_app 依赖应用目录能力，也需要 STEAM_WEB_API_KEY；即使传入数字 AppID，解析阶段也会先做目录校验。
• steam_me_* 依赖 STEAM_DEFAULT_STEAMID 作为默认账号；未配置时会返回明确错误。
• 不确定该用哪个单游戏工具时，优先使用 steam_get_app_snapshot 或 steam_me_game_snapshot。
• steam_me_recently_played、steam_me_badges、steam_me_bans 属于高频快捷入口；如果需要完整上下文，优先使用 steam_me_profile。
• 单游戏工具统一支持 appid 或 query，query 可直接输入中文游戏名。
• steam_get_achievement_roadmap 会抓取 Steam Guides，但只返回带来源的攻略事实和证据片段，不输出模型自行推断的阶段路线。
• steam_get_price_overview 支持 appid、subid、bundleid 三种目标；其中 query 仅用于解析 app。
• 如果终端环境访问外部站点不稳定，但浏览器或 Steam 客户端可以正常打开，可统一配置 PROXY_URL，例如 http://YOUR_PROXY_HOST:PORT。
• 返回结果会优先补充 localizedName 和 displayName；会先用官方 appdetails，必要时再回退到官方商店页展示名，仍拿不到中文名时才保留原始名称。
• 中文 query 对官方商店名和常见本地化标题支持较好；如果某个游戏在 Steam 商店本身没有稳定中文标题，仍建议直接传 appid。
• 好友、游戏库、成就等结果仍然会受目标账号隐私设置影响。
• Steam 官方文档里的 ISteamApps.GetAppList 当前已标记为 deprecated，本服务内部不会把它作为对外工具暴露。
• steam_get_price_overview 当前使用第三方公开价格源补充史低信息；如果第三方暂时不可用，工具会直接返回错误或 warning。

开发说明

• 工具注册统一走 src/tools/register-steam-tool.ts。
• npm run check:tool-registry 会检查 src/tools 下是否误用了 server.registerTool(...)。
• 同步后的接口快照保存在 src/generated/steam-web-api-spec.json，仅作为底层调用数据，不再直接暴露为对外工具。