BaranDev/videogames-mcp-server

Video Games MCP Server

A fast, reliable Model Context Protocol (MCP) server that provides access to RAWG's detailed gaming database through Claude Desktop. Search for games, get detailed information, explore genres, and discover popular titles - all without leaving your chat interface.

Why Use This?

Ever find yourself opening multiple browser tabs just to research a single game? This MCP server eliminates that hassle by bringing RAWG's entire gaming database directly into Claude Desktop. Whether you're trying to remember if "Cyberpunk 2077" is finally worth playing or need quick facts about indie games for your stream, just ask Claude and get instant, comprehensive answers.

Features

• Smart Game Search: Find games by title with fuzzy matching that actually works
• Comprehensive Game Details: Ratings, platforms, developers, release dates, descriptions, and more
• Genre Exploration: Browse complete game categories without falling into rabbit holes
• Popular Games Discovery: See what's trending without algorithm manipulation
• Seamless Claude Integration: Works directly in Claude Desktop - no app switching required
• Fast & Reliable: Built with FastMCP and async operations for speed

Test Results (click the arrows to see the screenshots)

📊 Test Results Summary

All tests return properly formatted game data with titles, ratings, platforms, and metadata.

Installation

Prerequisites

• Python 3.11 or higher
• RAWG API Key (free at rawg.io/apidocs)
• Claude Desktop application

Quick Setup

1. Clone and Navigate

git clone https://github.com/barandev/videogames-mcp-server.git
cd videogames-mcp-server

2. Create Virtual Environment

# With UV (recommended - faster)
uv venv
source .venv/bin/activate          # macOS/Linux
.\.venv\Scripts\Activate.ps1       # Windows PowerShell

# Or with standard Python
python -m venv .venv
# Then activate as above

3. Install Dependencies

pip install -r requirements.txt

4. Configure API Access

# Copy environment template
cp .env.example .env
# Edit .env and add your RAWG API key

💡 Get your free API key at rawg.io/apidocs - it's required for the server to function.

5. Verify Installation

python main.py

Claude Desktop Configuration

Windows Configuration:

Add this to your claude_desktop_config.json file:

{
  "mcpServers": {
    "videogames": {
      "command": "C:\\path\\to\\videogames-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\videogames-mcp-server\\main.py"],
      "cwd": "C:\\path\\to\\videogames-mcp-server",
      "env": {
        "RAWG_API_KEY": "your_api_key_here"
      }
    }
  }
}

macOS/Linux Configuration:

{
  "mcpServers": {
    "videogames": {
      "command": "/path/to/videogames-mcp-server/.venv/bin/python",
      "args": ["/path/to/videogames-mcp-server/main.py"],
      "cwd": "/path/to/videogames-mcp-server",
      "env": {
        "RAWG_API_KEY": "your_api_key_here"
      }
    }
  }
}

Note: Use absolute paths and restart Claude Desktop after making changes.

Available Tools

search_game_by_title

Search for games by title with fuzzy matching.

• Parameters: Game title, optional limit for results
• Returns: List of matching games with ratings, platforms, and screenshots

get_game_details

Get comprehensive information about a specific game.

• Parameters: Game ID (from search results)
• Returns: Description, developers, publishers, release dates, ratings, platforms, ESRB info

list_genres

List all available game genres.

• Parameters: None
• Returns: Complete list of genres with game counts

get_popular_games

Discover trending and highly-rated games.

• Parameters: Optional limit, optional genre filter
• Returns: List of popular games with metadata

License

MIT License - see file for details.