convez.ai
MCP ServerIntegração & APIsIntermediário
sharkusmanch

Steam MCP Server

sharkusmanch/steam-mcp-server

Integração Steam com suporte a biblioteca, conquistas e estatísticas de jogo

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a Steam Web API, permitindo acessar biblioteca de jogos, conquistas, tempo de jogo e dados de perfil diretamente via Claude, Cursor e outras ferramentas IA. Inclui paginação confiável, retry automático e suporte a múltiplos clientes MCP.

Instalação

$npx convez-ai sharkusmanch/steam-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
11
Contribuidores
4

Casos de uso

  • Consultar biblioteca de jogos e tempo de jogo via IA
  • Analisar conquistas e estatísticas de perfil Steam
  • Automatizar consultas de dados de jogador em workflows

Veredito

MCP server bem estruturado com integração robusta à Steam Web API, tratamento de erros confiável (retry exponencial, timeouts) e paginação consistente. Útil para quem precisa acessar dados Steam em ferramentas IA, embora requeira API key e configuração manual no cliente.

README

A tradução para o português deste README ainda está na fila.

Steam MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Steam Web API.

Setup

1. Get a Steam API Key

Obtain an API key from Steam's developer portal.

2. Install Dependencies

npm install

3. Build

npm run build

4. Configure Your MCP Client

Claude Code

Add to your Claude Code settings file (~/.claude/settings.json):

{
  "mcpServers": {
    "steam": {
      "command": "node",
      "args": ["/path/to/steam-mcp-server/dist/index.js"],
      "env": {
        "STEAM_API_KEY": "your-api-key-here",
        "STEAM_ID": "your-64-bit-steam-id"
      }
    }
  }
}

Or use npx (no build required):

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-mcp-server"],
      "env": {
        "STEAM_API_KEY": "your-api-key-here",
        "STEAM_ID": "your-64-bit-steam-id"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop configuration:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-mcp-server"],
      "env": {
        "STEAM_API_KEY": "your-api-key-here",
        "STEAM_ID": "your-64-bit-steam-id"
      }
    }
  }
}

Cursor

Add to Cursor's MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-mcp-server"],
      "env": {
        "STEAM_API_KEY": "your-api-key-here",
        "STEAM_ID": "your-64-bit-steam-id"
      }
    }
  }
}

Windsurf

Add to Windsurf's MCP configuration (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-mcp-server"],
      "env": {
        "STEAM_API_KEY": "your-api-key-here",
        "STEAM_ID": "your-64-bit-steam-id"
      }
    }
  }
}

Environment Variables

VariableRequiredDescription
STEAM_API_KEYYesYour Steam Web API key
STEAM_IDNoDefault Steam ID to use when not specified in tool calls
STEAM_HTTP_TIMEOUT_MSNoPer-request timeout for Steam API calls in milliseconds (default 10000)

When STEAM_ID is set, you can call tools like get_owned_games without passing a Steam ID - it will use your default profile automatically.

Reliability & Pagination

  • Every Steam API request is bounded by a timeout (STEAM_HTTP_TIMEOUT_MS) and automatically retries transient failures (timeouts, HTTP 429, and 5xx) with exponential backoff. Non-retriable errors (401/403/404) fail fast with a clear, actionable message, and failures are returned with isError: true.
  • List-returning tools accept limit and offset and return a consistent envelope with the pre-slice total and a has_more flag, e.g. { "total_games": 412, "returned": 50, "offset": 0, "has_more": true, "games": [...] }. get_inventory additionally returns a next_cursor (Steam start_assetid) for deep paging.
  • search_apps uses Steam's relevance-ranked storefront search (no full-catalog download), so it returns the top matches quickly and reliably.

Available Tools

Social & Profile

ToolDescription
get_player_summaryGet player profile info (name, avatar, status, current game)
get_friends_listGet a player's friends list
get_steam_levelGet player's Steam account level
get_badgesGet player's badges, XP, and level progression
get_badge_progressGet trading card collection progress
get_player_bansCheck for VAC bans, game bans, or trade bans
get_user_groupsGet Steam groups a player belongs to
resolve_vanity_urlConvert vanity URL to 64-bit Steam ID

Game Library

ToolDescription
get_owned_gamesGet all games owned with playtime stats (supports pagination)
get_recently_playedGet games played in last 2 weeks
get_game_detailsGet detailed game info (description, price, requirements)
is_playing_shared_gameCheck if playing via Steam Family Sharing
search_appsSearch Steam catalog by game name

Achievements & Stats

ToolDescription
get_achievementsGet player's achievements for a game
get_game_statsGet player's statistics for a game
get_global_achievement_percentagesGet global achievement unlock rates
get_global_game_statsGet global aggregated stats for a game
get_perfect_gamesGet games where player has 100% achievements
get_achievement_summaryGet condensed achievement progress across games
get_game_schemaGet achievement/stat definitions for a game

Game Info

ToolDescription
get_game_newsGet latest news and patch notes for a game
get_player_countGet current number of players in a game
get_servers_at_addressGet game servers at a specific IP
check_app_updateCheck if an app version is up to date

Inventory

ToolDescription
get_inventoryGet inventory for any game (requires public profile)
get_tf2_inventoryGet Team Fortress 2 inventory
get_csgo_inventoryGet CS2/CSGO inventory
get_dota2_inventoryGet Dota 2 inventory

Finding Your Steam ID

Use resolve_vanity_url with your custom profile URL, or find your 64-bit Steam ID at steamid.io.

License

MIT

Ver o original no GitHub

Bom para

Relacionados