AI导哈

Steam游戏库管理工具

用于管理Steam游戏库、成就、统计数据和商店发现的服务，适合游戏玩家和开发者使用。

  • by obrien-matthew
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 obrien-matthew/mcp-steam

使用说明

mcp蒸汽

适用于Steam的MCP服务器，专注于游戏库管理、成就、统计数据和商店发现。20个工具专为与Claude和其他LLM代理一起使用而设计。

先决条件

设置

1.获取您的Steam API密钥

  1. 去 Steam Web API关键页
  2. 使用您的Steam帐户登录
  3. 注册域名（任何名称均可供个人使用）
  4. 注意API密钥

2.查找您的Steam ID

您的Steam ID是您个人资料URL中的数字标识符。如果您的个人资料URL是 https://steamcommunity.com/profiles/1111111111111111，你的Steam ID是 1111111111111111.

如果您使用自定义URL（例如。， /id/username)，使用a 蒸汽ID查找器 查找数字ID。

3.安装

cd mcp-steam
uv sync

4.配置环境变量

在运行服务器之前设置这些：

export STEAM_API_KEY="your_api_key"
export STEAM_ID="your_steam_id"

5.测试连接

uv run mcp-steam

服务器在启动时通过获取玩家摘要来验证您的API密钥和Steam ID。

克劳德桌面/Claude代码配置

添加到您的MCP服务器配置中。如果从PyPI安装：

{
  "mcpServers": {
    "steam": {
      "command": "uvx",
      "args": ["mcp-steam"],
      "env": {
        "STEAM_API_KEY": "your_api_key",
        "STEAM_ID": "your_steam_id"
      }
    }
  }
}

或者，如果从本地克隆运行：

{
  "mcpServers": {
    "steam": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-steam", "run", "mcp-steam"],
      "env": {
        "STEAM_API_KEY": "your_api_key",
        "STEAM_ID": "your_steam_id"
      }
    }
  }
}

工具

用户分辨率

工具 参数 说明
resolve_vanity_url vanity_name 将自定义配置文件URL名称转换为64位Steam ID

图书馆

工具 参数 说明
get_owned_games sort_by="playtime", limit=50 带游戏时间的游戏库。按播放时间、最近或姓名排序。
get_recently_played limit=10 过去两周玩的游戏。

游戏信息

工具 参数 说明
get_game_details app_id 商店页面信息：描述、价格、流派、元符号、平台。
search_games query, limit=10 搜索Steam商店。
get_current_players app_id 游戏的实时并发玩家计数。
get_game_schema app_id 游戏的成就和统计定义。
get_app_reviews app_id, review_type="all", limit=10 用户评论，包括推荐、播放时间和帮助。
get_package_details package_id 捆绑/套餐定价，包括应用程序和平台。

成就与统计

工具 参数 说明
get_achievements app_id 您的成就进度与全球稀有百分比。
get_player_stats app_id 游戏特定的统计数据（击杀、死亡等）。
get_global_achievement_stats app_id 所有成就的全局解锁百分比。

愿望清单

工具 参数 说明
get_wishlist limit=50 您的愿望清单按优先级排序，包括价格和折扣。

新闻

工具 参数 说明
get_game_news app_id, count=5 游戏的最新消息和更新。

简介

工具 参数 说明
get_player_summary steam_id="" 配置文件摘要。接受Steam ID或虚荣名称；默认为您。
get_friend_list steam_id="" 好友列表。接受Steam ID或虚荣名称；默认为您。
get_player_bans steam_id="" VAC、社区、游戏和贸易禁令状态。默认为您。
get_steam_level steam_id="" 玩家的蒸汽水平。默认为您。

商店发现

工具 参数 说明
get_featured_games （无） 目前有特色和在售游戏。
get_featured_categories （无） 畅销书、新发行、特价、即将上市等。

Steam Web API注释

  • API密钥安全性： 您的配置文件包含您的Steam API密钥。永远不要将其提交给版本控制或公开共享。
  • 费率限制： Steam Web API有未记录的费率限制。如果你点击了它们，服务器将返回一个速率限制错误。
  • 配置文件可见性： 某些工具要求您的Steam个人资料公开（成就、游戏统计数据）。库数据无论如何都有效。
  • 游戏统计数据可用性： 并非所有游戏都通过API公开统计数据。 get_player_stats 对于不支持的游戏，将返回错误。
  • 愿望清单访问： 愿望清单数据要求您的个人资料的愿望清单公开。

发展

uv run mcp-steam              # Run the server
uv run ruff check src/       # Lint
uv run ruff format src/      # Format
uv run pyright src/          # Type check

预提交钩子

此项目使用 左钩 用于预提交检查。安装时使用 brew install lefthook （或参见 其他安装方法)那么：

lefthook install

相关 MCP