CodeKeanu/steam-mcp

Steam MCP Server

A Model Context Protocol (MCP) server that lets AI assistants like Claude talk to the Steam API. Ask about your games, achievements, playtime, and more.

What Can It Do?

Once set up, you can ask Claude things like:

• "What games do I own?"
• "Show my achievements for Counter-Strike 2"
• "What are the rarest achievements in Elden Ring?"
• "How many hours have I played this week?"
• "What's the latest news for Team Fortress 2?"
• "Show my pending trade offers"
• "What's the current price for an AK-47 Redline?"

The server includes 36 tools covering player profiles, game libraries, achievements, stats, reviews, wishlists, news, community guides, trading/market data, family sharing, and Steam Workshop.

Quick Start (Non-Developers)

Just want to get it running? Here's the fastest path using Docker.

What You'll Need

1. Docker - Get Docker Desktop
2. Steam API Key - Grab one here (it's free)
3. Your SteamID64 - Find it at steamid.io by pasting your profile URL

Setup

1. Create a file called .env somewhere you'll remember (like your Documents folder):

STEAM_API_KEY=your_api_key_here
STEAM_USER_ID=your_steamid64_here

2. Add this to your Claude Desktop config:

Config location:

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

{
  "mcpServers": {
    "steam": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/full/path/to/your/.env",
        "ghcr.io/codekeanu/steam-mcp:latest"
      ]
    }
  }
}

Heads up: Replace /full/path/to/your/.env with the actual path to your .env file. On Windows, use forward slashes like C:/Users/YourName/Documents/.env.

3. Restart Claude Desktop and you're good to go!

Developer Setup

Want to build from source, contribute, or hack on the code? This section's for you.

Prerequisites

• Python 3.12+
• Git
• Steam API Key (get one here)

Installation

# Clone it
git clone https://github.com/CodeKeanu/steam-mcp.git
cd steam-mcp

# Set up a virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in dev mode
pip install -e ".[dev]"

# Configure your keys
cp .env.example .env
# Edit .env with your STEAM_API_KEY and STEAM_USER_ID

Running Locally

For development, point Claude Desktop directly at your local install:

{
  "mcpServers": {
    "steam": {
      "command": "/path/to/steam-mcp/.venv/bin/steam-mcp",
      "env": {
        "STEAM_API_KEY": "your_api_key_here",
        "STEAM_USER_ID": "your_steamid64_here"
      }
    }
  }
}

Development Commands

# Run tests
source .venv/bin/activate
pytest

# Run tests with coverage
pytest --cov=src/steam_mcp --cov-report=term-missing

Docker (Local Builds)

# Build from source
docker compose --profile local build steam-mcp-local

# Run your local build
docker compose --profile local up steam-mcp-local

# Dev mode with volume mount (reflects code changes on restart)
docker compose --profile dev up steam-mcp-dev

Adding New Endpoints

Create a new file in src/steam_mcp/endpoints/ - it gets auto-discovered:

from steam_mcp.endpoints import BaseEndpoint, endpoint
from steam_mcp.utils import normalize_steam_id

class INewInterface(BaseEndpoint):
    """Your new Steam API interface."""

    @endpoint(
        name="my_new_tool",
        description="What this tool does",
        params={
            "steam_id": {
                "type": "string",
                "description": "Steam ID in any format",
                "required": True,
            },
        },
    )
    async def my_new_tool(self, steam_id: str) -> str:
        normalized_id = await normalize_steam_id(steam_id, self.client)
        result = await self.client.get("INewInterface", "Method", version=1, params={...})
        return "Formatted result"

No registration needed - just drop in the file and restart.

Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/cool-thing)
3. Make your changes
4. Run tests and linting
5. Push and open a PR

Available Tools (36 total)

Player Profiles (ISteamUser) - 6 tools

Game Library (IPlayerService) - 4 tools

Achievements & Stats (ISteamUserStats) - 6 tools

Game Info (ISteamApps) - 6 tools

Game News (ISteamNews) - 1 tool

Wishlist & Pricing (ISteamWishlist) - 3 tools

Community Guides (ISteamGuides) - 2 tools

Trading & Market (IEconService) - 4 tools

Family Sharing (IFamilyGroupsService) - 2 tools

Steam Workshop (IPublishedFileService) - 4 tools

Configuration Reference

Steam ID Formats

The server understands all these formats:

• 76561198000000000 (SteamID64)
• STEAM_0:0:19867136 (SteamID)
• [U:1:39734272] (SteamID3)
• https://steamcommunity.com/id/username (Vanity URL)
• https://steamcommunity.com/profiles/76561198000000000 (Profile URL)
• username (Just the vanity name)

License

MIT - do whatever you want with it.