Query your Steam library: games, playtime, recently played titles and store metadata.

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. steam-mcp
  2. Tools
  3. Requirements
  4. Setup
  5. Local development
  6. Configuration
  7. Caching
  8. Troubleshooting
  9. License

steam-mcp

A local Model Context Protocol (MCP) server that connects Claude to your Steam library. Ask natural-language questions about your games without ever touching the API yourself.

"What have I been playing lately?"
"Suggest something from my backlog I haven't touched yet."
"How many hours have I put into RPGs?"
"Tell me about Elden Ring."

Tools

ToolWhat it does
get_libraryYour full game library — title, playtime, last played
get_recently_playedGames played in the last 2 weeks
search_libraryFilter by name, playtime range, or unplayed status
get_game_detailsStore metadata — genres, tags, Metacritic score, price
refresh_libraryClear the cache to fetch fresh data from Steam

Requirements

  • Node.js 18+
  • A Steam account with a public profile and library
  • A Steam Web API key (free, takes 30 seconds to get)

Setup

1. Get a Steam API key

Go to steamcommunity.com/dev/apikey, log in, and register a key. The domain field can be anything (e.g., localhost).

2. Find your Steam ID

You need either:

  • Your vanity URL username — the custom part of your profile URL: steamcommunity.com/id/YOUR_USERNAME
  • Your 64-bit Steam ID — find it at steamid.io if you don't have a vanity URL
3. Make your profile public

In Steam: your profile → Edit Profile → Privacy Settings → set My Profile and Game details to Public.

4. Run setup
npx steam-mcp setup

This validates your credentials and writes the Claude Desktop config automatically. Restart Claude Desktop when it's done.

Manual config (if you prefer)

Find your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add to the mcpServers section:

{
  "mcpServers": {
    "steam-mcp": {
      "command": "npx",
      "args": ["-y", "steam-mcp"],
      "env": {
        "STEAM_API_KEY": "your_api_key_here",
        "STEAM_ID": "your_vanity_url_or_64bit_id"
      }
    }
  }
}

Local development

git clone https://github.com/jkiley129/steam-mcp.git
cd steam-mcp
npm install
cp .env.example .env
# Edit .env with your API key and Steam ID
npm run build

To use the local build with Claude Desktop, point the config at the built file:

{
  "mcpServers": {
    "steam": {
      "command": "node",
      "args": ["/absolute/path/to/steam-mcp/dist/index.js"],
      "env": {
        "STEAM_API_KEY": "your_api_key_here",
        "STEAM_ID": "your_vanity_url_or_64bit_id"
      }
    }
  }
}

Configuration

Environment variableRequiredDescription
STEAM_API_KEYYesYour Steam Web API key
STEAM_IDYesYour 64-bit Steam ID or vanity URL username
STEAM_MCP_CACHE_DIRNoOverride cache directory (default: ~/.steam-mcp/cache/)

Caching

Steam data is cached locally to keep responses fast and avoid hitting rate limits:

DataCache TTL
Library1 hour
Recently played30 minutes
Game details24 hours

Use the refresh_library tool to clear the cache immediately (e.g., after buying new games).


Troubleshooting

"Steam returned no library data" Your Steam profile or game library is set to private. Go to Steam → your profile → Edit Profile → Privacy Settings and set both to Public.

"Could not resolve Steam vanity URL" Check that STEAM_ID matches the username in your Steam profile URL (steamcommunity.com/id/YOUR_USERNAME). Alternatively, use your numeric 64-bit Steam ID.

"Could not validate Steam API key" Verify your API key at steamcommunity.com/dev/apikey. Keys are tied to your Steam account login.

Tools not showing in Claude Restart Claude Desktop fully (quit from the system tray, not just close the window) after editing the config file. Check that Node.js 18+ is installed by running node --version in a terminal.


License

MIT

الأسئلة الشائعة

ما هو Steam MCP؟

Query your Steam library: games, playtime, recently played titles and store metadata.

كيف أثبّت Steam MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Steam MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Steam MCP؟

ينشره jkiley129. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.