Steam MCP Server

Steam MCP 服务

一个适用于 Steam 的 MCP 服务：搜索游戏并读取商店详情、价格、评价、折扣和新闻（无需密钥），还可通过官方 Steam Web API（免费密钥）查看玩家个人资料、游戏库和成就。

只读 · 仅使用 Steam 官方 API · 大多数工具无需密钥 · 开源。

不会有人登录；唯一的凭据是你自行设置的免费 Steam Web API 密钥，且服务绝不会写入、交易、发帖、启动游戏或进行购买。

可通过标准输入/输出与任何 MCP 客户端配合使用（Claude Desktop/Code、Cursor、VS Code、Cline 等）。

连接后，只需用自然语言向 Agent 提问。

无需凭据（商店、搜索和探索）：

"Find Hollow Knight and tell me its price, genres and age rating."
"What are recent reviews saying about Baldur's Gate 3?"
"Have Cyberpunk 2077's reviews recovered since launch?"
"Which games are >80% off right now with 90%+ positive reviews?"
"Find roguelike deckbuilders on sale."
"What discounted games run natively on macOS?"
"Which recent, well-reviewed games run on Steam Deck?"
"What well-reviewed games run on SteamOS?"
"Any games verified for the Steam Machine on sale?"
"Any Steam Frame-Verified VR games on sale?"
"What's discounted on Steam's front page right now?"
"Show me Steam's top sellers and newest releases."
"Any recent patch notes for No Man's Sky?"
"How rare is each achievement in Elden Ring?"
"How many people are playing Counter-Strike 2 right now?"
"What are the most played games on Steam right now?"
"Get current prices for appids 620, 413150 and 1145360."
"For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Machine / Frame status."

使用免费 API 密钥 + 你的 STEAM_ID（你的账户；请参阅获取凭据）：

"Show my Steam profile."
"List my games by playtime."
"What have I played in the last two weeks?"
"Recommend something I'd like based on my library, on a good discount."
"Do I already own Hollow Knight and Hades?"
"What's on my wishlist that's discounted and well-reviewed?"
"List Hollow Knight's achievements and how rare each one is."
"How far am I through Elden Ring's achievements?"
"What's the SteamID64 for the profile name 'gabelogannewell'?"
"Which of my friends own Portal 2, and how many hours have they played?"
"What games do my friend and I both own, and who's played them more?"
"Show me my Steam friends list."
"Is SteamID 76561197960287930 VAC banned?"
"What games am I following that aren't on my wishlist?"

安装

将其添加到 MCP 客户端的配置中。商店/搜索工具无需凭据；玩家工具需要免费的 Steam Web API 密钥。

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-games-mcp"],
      "env": {
        "STEAM_API_KEY": "your-steam-web-api-key (optional — enables player tools)",
        "STEAM_ID": "your-steamid64-or-vanity-name (optional — default 'you' for player tools)",
        "STEAM_COUNTRY": "US (optional — store price region)",
        "STEAM_LANGUAGE": "english (optional — store language)"
      }
    }
  }
}

将每个值替换为你自己的值；删除不需要的可选行。 免费密钥可从 https://steamcommunity.com/dev/apikey 获取。从源代码安装： npm ci && npm run build，然后使用 "command": "node"、 "args": ["/ABS/PATH/steam-games-mcp/dist/index.js"]。

一键安装（Claude Desktop）

下载steam-games-mcp.mcpb （始终是最新版本），并在 Claude Desktop 中打开（Settings → Extensions），然后在安装表单中填写可选字段（API 密钥、Steam ID、国家/地区、语言）。无需编辑 JSON。

也已在 MCP Registry 中列出，名称为 io.github.Grinv/steam-games-mcp。

获取凭据

商店、搜索和探索工具无需任何凭据；如果你只需要这些功能，可以跳过本节。玩家工具（个人资料、游戏库、成就）需要免费 API 密钥，且大多数还需要公开个人资料——不过 get_wishlist 和 get_followed_games 无需密钥，个人资料/封禁查询也适用于私人个人资料。只需三个简短步骤：

1. 获取免费的 Steam Web API 密钥。 在 https://steamcommunity.com/dev/apikey 登录，输入任意域名（例如 localhost）， 并将密钥复制到 STEAM_API_KEY。

2. 查找你的 Steam ID。 将 STEAM_ID 设置为以下任一值：

   • 你的自定义名称：个人资料 URL 中的自定义部分 steamcommunity.com/id/YOUR_NAME → YOUR_NAME（会自动解析），或
   • 你的 17 位 SteamID64（steamcommunity.com/profiles/7656…；也可以在 https://steamid.io 查询）。

   设置 STEAM_ID 后，你可以直接询问“_我的_愿望单/游戏库”；若未设置， 则每次都要向 Agent 提供 SteamID64（使用 resolve_vanity_url 转换名称）。

3. 将个人资料设为公开（用于查看你自己的游戏库/成就）：Steam → 个人资料 → 编辑个人资料 → 隐私设置 → 将我的个人资料和 游戏详情设为公开。

将密钥和 Steam ID 填入 MCP 客户端配置（上方的 env 区块）。按客户端查看示例，请参阅 docs/clients.md。切勿提交这些信息。

工具

密钥：– 无需凭据 · K Steam Web API 密钥。

工具	密钥	用途
search_games	–	按标题查找游戏 → appid（包含价格、Metacritic 评分、类型），最多 100 个匹配项
get_game	–	按 appid 或名称获取商店详情：价格、类型、平台、Metacritic 评分、年龄分级、DLC、配置要求
get_items	–	批量获取商店卡片（价格、评价好评率、Deck/SteamOS/Machine/Frame 兼容性、原生平台、标签），最多 50 个 appid
discover_games	–	在整个游戏目录中查找游戏，可按折扣、上架时间、Deck/SteamOS/Machine/Frame、平台、标签、评分筛选
get_game_reviews	–	评价摘要 + 最有帮助的评价（任意一年内的时间范围）或最新评价
get_review_histogram	–	评价趋势随时间的变化（历史 + 近期）
get_prices	–	批量获取当前价格/折扣，最多 250 个 appid
get_specials	–	Steam 首页折扣
get_featured	–	精选版块（畅销商品、新发售游戏等）
get_game_news	–	最新新闻，或仅查看开发者发布的文章/补丁说明
get_global_achievements	–	全球成就解锁率（稀有度），最多 200 项
get_current_players	–	实时同时在线玩家数
get_charts	–	当前热门内容：每周畅销榜（全球或按国家/地区，可查询过去任意一周）、最常玩的游戏（也包括 Steam Deck）、实时同时在线人数前 100 名（排名 + appid）
get_wishlist	–	玩家愿望单：appid，或完整卡片 + 在售筛选（使用 include_details，适用于公开个人资料）
get_followed_games	–	玩家关注的游戏（Steam 的“关注”功能，与愿望单分开），appid（适用于公开个人资料）
get_game_achievements	K	成就列表（名称、描述）+ 稀有度，按定义顺序列出前 150 项
resolve_vanity_url	K	自定义个人资料名称 → SteamID64
get_player_summary	K	玩家公开个人资料（包括 Steam 等级）
get_player_bans	K	VAC/游戏/社区/经济封禁状态（对私密个人资料也有效）
get_owned_games	K	玩家的游戏 + 游戏时间（按游戏时间列出前 50 款；limit 可扩展至 300 款，sort 可切换保留哪一端；check_appids 可可靠地检查超出此范围的特定 appid）
get_recently_played	K	过去两周内玩过的游戏（按近期游戏时间列出前 50 款）
get_recommended_games	K	根据游戏时间加权标签 + 评价质量提供个性化推荐，并排除已拥有的游戏
get_player_achievements	K	玩家在某款游戏中的成就进度 — 成就列表最多列出前 200 项，已解锁的排在前面
get_friend_list	K	玩家的好友 — 名称、在线状态、当前游戏（公开好友列表）
find_friends_who_own	K	哪些好友拥有指定 appid，以及他们的游戏时间 — 检查每位好友的完整游戏库，最多检查前 200 位好友（friends_checked）
compare_players	K	两位玩家共同拥有的游戏，以及各自的游戏时间 — 检查每位玩家的完整游戏库，而不仅是前 50 款
两类工具。 存储／搜索和发现工具（store/api.steampowered.com）
无需凭据即可使用——包括全目录发现（discover_games：
优惠、新品、Deck / SteamOS / Machine / Frame 兼容性、标签、评分）以及批量
价格／评测查询（get_items）。
玩家工具需要免费的
STEAM_API_KEY 和一个公开个人资料；未设置密钥时，它们会返回明确提示。两个例外是上方标记为 – 的 get_wishlist 和 get_followed_games：它们完全无需密钥即可使用。设置 STEAM_ID（SteamID64
或自定义名称——无需密钥也能解析自定义名称），可让这些工具默认使用你的账号，这样无需每次传入 ID，就能使用“我的愿望单／库”。

不使用第三方服务：优惠发现和评测来自 Steam 自有的 （无需密钥）商店 API。不会使用 SteamDB（没有公开 API，且禁止抓取）。 Steam 没有价格历史 API，因此不提供相关功能。与 Valve 无关联。

提示词

引导式单次提示词，可通过编排多个工具来回答常见问题。 如果你的客户端支持 MCP 提示词，请使用这些提示词，而不是自行描述操作步骤：

提示词	参数	功能说明
what_should_i_play	steamid、budget、tags（均可选）	根据你的库／偏好推荐目录中的游戏，并排除你已拥有的游戏
is_it_worth_buying	game（标题或 appid，可选，可自动补全；省略时会询问）	价格、评测趋势和 Steam Deck 兼容性 → 给出购买／等待／跳过的建议
deals_digest	min_discount、min_review、tags（均可选）	精选好评折扣游戏列表

开发

npm install
npm run build        # type-check + bundle to dist/index.js
npm test             # node:test (mocked, offline)
npm run lint
npm run format
npm run check:api    # live upstream health-check (key-gated checks need STEAM_API_KEY; a public STEAM_ID verifies player fields)
npm run inspector    # run under the MCP Inspector

运行时要求 Node ≥ 22.18。贡献者／Agent 指南： AGENTS.md。 安全政策：SECURITY.md。 各客户端配置和所有可调参数： docs/clients.md。

更新

• npx： 未锁定版本的 npx -y steam-games-mcp 会在下次运行时获取最新版本。
• .mcpb bundle： 从 releases 页面下载新 bundle 并重新安装。
• 从源代码： git pull && npm ci && npm run build。

隐私政策

steam-games-mcp 完全在你自己的机器上运行，不会自行收集任何数据。请参阅 PRIVACY.md，了解它具体会向 Steam 发送哪些信息，以及会在本地存储哪些信息（如果有）。

许可证

MIT © Grinv