rom-mcp

ROM MCP

An MCP server for searching, verifying, and managing game ROM collections. Search Internet Archive, verify checksums against No-Intro and Redump databases, parse emulator save files, and download ROMs.

What it does

Search for ROMs across Internet Archive, ROMsgames.net, CoolROM, Arcade Punks, ROMsFun, and Reddit r/Roms. Verify ROM integrity using checksums. Identify unknown ROMs by hash. Parse save files to check playtime and progress. Scan entire collections and catalog everything.

Supported Sources

• Internet Archive - Search via the IA API
• ROMsgames.net - HTML scraping
• CoolROM - HTML scraping
• Arcade Punks - HTML scraping
• ROMsFun - HTML scraping
• Reddit r/Roms - Community discussions and recommendations

Tools

• search_rom. Search Internet Archive for game ROMs by title or keyword.
• search_all_sources. Search across all ROM sources (Internet Archive, ROMsgames, CoolROM, Arcade Punks, ROMsFun, Reddit r/Roms).
• search_romsgames. Search ROMsgames.net for ROMs.
• search_coolrom. Search CoolROM for ROMs.
• search_arcadepunks. Search Arcade Punks for ROMs.
• search_romsfun. Search ROMsFun for ROMs.
• search_reddit_roms. Search Reddit r/Roms for community discussions and recommendations.
• verify_rom. Compute MD5 and SHA1 checksums and verify against known databases.
• match_by_checksum. Identify a game by providing its hash.
• parse_save_file. Read emulator save files (.sav, .srm, .states).
• scan_collection. Scan a directory and identify all ROM files.
• get_download_link. Get direct download URL from Internet Archive.
• download_rom. Download a ROM to a local directory.
• detect_console. Detect the console from filename or path.

Install

npx rom-mcp

Claude Desktop setup

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "rom": {
      "command": "npx",
      "args": ["-y", "rom-mcp"]
    }
  }
}

Example usage

Ask Claude:

"Search Internet Archive for Super Mario World ROMs"

"Verify this ROM file at ~/Downloads/game.sfc"

"What game is this? MD5: a1b2c3d4e5f6..."

"Scan my ROM collection at ~/ROMs and tell me what I have"

"Download the Sonic the Hedgehog ROM to my desktop"

"Parse this save file and tell me how much playtime I have"

Checksum verification

The server computes MD5 and SHA1 hashes of ROM files and checks them against known databases to verify integrity and identify games.

Save file support

Parses common emulator save formats including .srv, .srm, .sav, .states, and .ss files.

License

MIT