steam-mcp

一个将 Steam Web API 暴露给任何 AI 工具（Claude Desktop、Claude Code、Cursor、Cline、Windsurf，或任何支持 Model Context Protocol 的工具）的 MCP 服务器。

你可以向你的助手提问，比如 "我在 Team Fortress 2 上投入了多少小时？"、"我朋友拥有的游戏中哪些玩得最多？" 或 "总结一下 Baldur's Gate 3 的评测" —— 它会实时从 Steam 获取答案。

为什么

Steam Web API 功能强大但结构庞杂：数十个接口、不一致的数据结构、64 位 SteamID、一个未文档化的商店 API，以及任何与玩家相关的功能都必需的密钥。steam-mcp 将有用的部分封装成一组小巧、文档完善的面向工作流的 MCP 工具，返回对 LLM 友好、节省 token 的响应。

Related MCP server: Steam MCP Server

快速开始

使用玩家/个人资料工具需要 Steam Web API 密钥。在 https://steamcommunity.com/dev/apikey 免费获取一个。商店工具（应用详情、评测、搜索）无需密钥即可使用。

无需安装，直接通过 uv 从 GitHub 运行（现在即可使用 —— PyPI 发布即将推出）：

STEAM_API_KEY=xxxxxxxx uvx --from git+https://github.com/rachittshah/steam-mcp steam-mcp

或者从源码安装：

uv pip install git+https://github.com/rachittshah/steam-mcp
# once published to PyPI: uv pip install steam-mcp

Claude Desktop / Claude Code

添加到你的 MCP 配置（claude_desktop_config.json，或 Claude Code 使用 .mcp.json）：

{
  "mcpServers": {
    "steam": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rachittshah/steam-mcp", "steam-mcp"],
      "env": { "STEAM_API_KEY": "your-key-here" }
    }
  }
}

（PyPI 发布后，args 可简化为 ["steam-mcp"]。）

Cursor / Cline / Windsurf

将 MCP 服务器命令指向相同的 uvx --from git+... steam-mcp 调用，并在环境中设置 STEAM_API_KEY。各客户端的详细说明请参阅 docs/clients.md。

配置

工具

完整的工具参考文档位于 docs/tools.md。亮点包括：

• 身份 — resolve_vanity_url、get_player_summary、get_player_bans、get_steam_level

• 游戏库 — get_owned_games、get_recently_played_games、get_friend_list

• 成就与统计 — get_player_achievements、get_game_schema、get_global_achievement_percentages、get_current_player_count

• 商店 — get_app_details、get_app_reviews、search_store

• 新闻 — get_news_for_app

示例提示

连接后，尝试向你的助手提问：

• "现在有多少人在玩 Counter-Strike 2？" → search_store → get_current_player_count

• "Team Fortress 2 中最稀有的成就是什么？" → get_global_achievement_percentages

• "总结 Elden Ring 的近期评测。" → search_store → get_app_reviews

• "steamcommunity.com/id/gabelogannewell 是谁的个人资料，他们在玩什么？" → get_player_summary

• "我玩得最多的 5 款游戏是什么？"（需要你的 SteamID）→ get_owned_games

• "Dota 2 最近有补丁说明吗？" → get_news_for_app

开发

git clone https://github.com/rachittshah/steam-mcp
cd steam-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
ruff check . && mypy src && pytest

贡献

欢迎贡献 —— 请参阅 CONTRIBUTING.md。

许可证

MIT © Rachitt Shah。与 Valve Corporation 无关联，亦未获得其认可。Steam 和 Steam 徽标是 Valve Corporation 的商标。