mobygames-mcp

A stdio MCP server for the MobyGames API plus read-only querying of local JSON Moby downloads.

Install and build

npm install
npm run build

MCP configuration

Pass secrets through your MCP client's environment configuration. Do not put API keys in this repository.

{
  "mcpServers": {
    "mobygames": {
      "command": "node",
      "args": ["/path/to/mobygames-mcp/dist/index.js"],
      "env": {
        "MOBYGAMES_API_KEY": "YOUR_MOBYGAMES_API_KEY",
        "MOBYGAMES_DOWNLOADS_DIR": "/home/you/Downloads/moby"
      }
    }
  }
}

MOBYGAMES_API_KEY is required only when calling API-backed tools. Local download tools work without an API key. MOBYGAMES_DOWNLOADS_DIR defaults to ~/Downloads/moby.

API tools

The server exposes typed tools for MobyGames v1 GET endpoints: games, game details, game platform lists, platform-specific game subresources, platforms, genres, attributes, groups, companies, people, rating systems, and credit roles. It also includes moby_api_get, a read-only escape hatch for newly documented v1 GET paths.

See docs/api-inventory.md for the current endpoint mapping and verification notes.

Local JSON Moby download tools

Local downloads are read-only and support .json and .html files containing JSON arrays of game summaries.

• moby_download_list_files lists local files and optional entry counts.
• moby_download_file_page returns a bounded page from one file.
• moby_download_search_games searches by title, genre, release year, score range, and optional file.
• moby_download_get_game_by_id finds matching entries by game id, including duplicates across files.

Results are capped by tool input limits to avoid returning very large local files in one MCP response.

Development

npm run typecheck
npm test
npm run build
gitleaks detect --redact --verbose --source .

A fail-closed gitleaks pre-commit hook is installed in .git/hooks/pre-commit for this checkout.

License

AGPL-3.0-only. See LICENSE.