MCP 服务器

Steam-MCP

MCP server for Valve's Steam that enables querying game libraries, player profiles, achievements, friends, store listings, Workshop items, and current player counts. Provides 14 tools across 5 categories with a React dashboard and REST bridge.

README

Steam-MCP

MCP server for Valve's Steam — query your game library, player profile, achievements, friends, store listings, Workshop items, and current player counts. 14 tools across 5 categories, with a React dashboard and REST bridge.

Features

Profile — look up yourself, any player, friends list, resolve vanity URLs
Library — owned games with playtime, recently played, detailed store info (no key needed)
Stats — per-game achievements, global achievement percentages, current player counts, leaderboards
Store & News — latest news per game, search the store by name
Workshop — query published workshop items by app, sort by popularity/recency

No API key needed for: store details, player counts, news, achievement percentages, and store search. API key unlocks profile, library, friends, and Workshop.

Quick Start

# 1. Clone & install
git clone https://github.com/sandraschi/steam-mcp.git
cd steam-mcp
uv sync

# 2. Set your Steam Web API key (free)
#    Get one: https://steamcommunity.com/dev/apikey
$env:STEAM_API_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
$env:STEAM_ID = "7656119xxxxxxxxxx"   # your 64-bit Steam ID

# 3. Start the server
just serve

Server runs on http://localhost:11020. MCP endpoint at http://localhost:11020/mcp. REST bridge at /api/status, /api/tools, /api/tools/{name}/call.

Tools

Profile

Tool	Description	Key
`get_own_profile`	Player summary for configured STEAM_ID	Yes
`get_player_summaries(steamids)`	Look up any player(s) by Steam ID	Yes
`get_friend_list(steamid)`	List friends for a user	Yes
`resolve_vanity_url(vanity_url)`	Resolve custom URL to 64-bit Steam ID	Yes

Library

Tool	Description	Key
`get_owned_games(steamid)`	Full game library with playtime	Yes
`get_recently_played_games(steamid)`	Recently played games	Yes
`get_app_details(app_id)`	Store page data (name, price, description, screenshots)	No

Stats

Tool	Description	Key
`get_player_achievements(steamid, app_id)`	Player's achievements for a game	Yes
`get_global_achievement_percentages(app_id)`	Global completion rates	No
`get_number_of_current_players(app_id)`	Concurrent players right now	No
`get_game_leaderboards(app_id)`	List leaderboards for a game	Yes

Store & News

Tool	Description	Key
`get_news_for_app(app_id)`	Latest news articles	No
`search_store(query)`	Search games by name	No

Workshop

Tool	Description	Key
`query_workshop_items(app_id, query)`	Query Workshop items	Yes

Usage

As an MCP server (for AI assistants)

Connect any MCP-compatible client to the STDIO or HTTP endpoint:

// Claude Desktop, opencode, etc.
{
  "mcpServers": {
    "steam": {
      "command": "uv",
      "args": ["run", "steam-mcp"],
      "env": {
        "STEAM_API_KEY": "...",
        "STEAM_ID": "..."
      }
    }
  }
}

Or via HTTP SSE:

{
  "mcpServers": {
    "steam": {
      "url": "http://localhost:11020/mcp"
    }
  }
}

Via REST API

# Status
curl http://localhost:11020/api/status

# List tools
curl http://localhost:11020/api/tools

# Call a tool
curl -X POST http://localhost:11020/api/tools/get_number_of_current_players/call \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"app_id": 440}}'

Via React Dashboard

start.ps1         # launches backend + frontend
# or
just frontend-dev # frontend only on http://localhost:11021

Godot + Steam Publishing

This MCP handles accessing Steam data. To publish a Godot game on Steam:

GodotSteam (godotsteam.com) — GDExtension that wraps Steamworks SDK as native Godot nodes. Handles achievements, leaderboards, lobbies, networking, Workshop, overlay, DRM, cloud saves.
Steamworks Partner — Register at partner.steamgames.com. $100 Steam Direct fee per game, recoupable after $1K revenue. 70/30 revenue split.
SteamPipe — Upload builds via steamcmd.exe. Supports delta patching, beta branches, rollbacks.

Architecture

src/steam_mcp/
  server.py          # FastAPI + MCP HTTP composition
  web.py             # REST bridge
  transport.py       # STDIO/HTTP transport
  config.py          # Env-based settings
  mcp/
    registry.py      # Shared FastMCP instance
    tools/           # Tool implementations (14 tools, 5 files)
      profile.py library.py stats.py store.py workshop.py
webapp/              # Vite React dashboard (TypeScript, Tailwind)
native/              # Tauri 2.0 scaffold (placeholder)

Development

uv sync                # Install Python deps
npm --prefix webapp i  # Install frontend deps
just serve             # Dev server with hot reload
just lint              # Ruff check
npm run build -w webapp    # Build frontend