rom-mcp

ROM MCP

Um servidor MCP para pesquisar, verificar e gerenciar coleções de ROMs de jogos. Pesquise no Internet Archive, verifique checksums em relação aos bancos de dados No-Intro e Redump, analise arquivos de save de emuladores e baixe ROMs.

O que ele faz

Pesquise ROMs no Internet Archive, ROMsgames.net, CoolROM, Arcade Punks, ROMsFun e Reddit r/Roms. Verifique a integridade das ROMs usando checksums. Identifique ROMs desconhecidas por hash. Analise arquivos de save para verificar tempo de jogo e progresso. Examine coleções inteiras e catalogue tudo.

Fontes suportadas

• Internet Archive - Pesquise via API do Internet Archive
• ROMsgames.net - HTML scraping
• CoolROM - HTML scraping
• Arcade Punks - HTML scraping
• ROMsFun - HTML scraping
• Reddit r/Roms - Discussões e recomendações da comunidade

Ferramentas

• search_rom. Pesquise ROMs de jogos no Internet Archive por título ou palavra-chave.
• search_all_sources. Pesquise em todas as fontes de ROM (Internet Archive, ROMsgames, CoolROM, Arcade Punks, ROMsFun, Reddit r/Roms).
• search_romsgames. Pesquise ROMs no ROMsgames.net.
• search_coolrom. Pesquise ROMs no CoolROM.
• search_arcadepunks. Pesquise ROMs no Arcade Punks.
• search_romsfun. Pesquise ROMs no ROMsFun.
• search_reddit_roms. Pesquise no Reddit r/Roms por discussões e recomendações da comunidade.
• verify_rom. Calcule checksums MD5 e SHA1 e verifique em relação aos bancos de dados conhecidos.
• match_by_checksum. Identifique um jogo fornecendo seu hash.
• parse_save_file. Leia arquivos de save de emuladores (.sav, .srm, .states).
• scan_collection. Examine um diretório e identifique todos os arquivos de ROM.
• get_download_link. Obtenha a URL de download direto do Internet Archive.
• download_rom. Baixe uma ROM para um diretório local.
• detect_console. Detecte o console a partir do nome do arquivo ou caminho.

Instalação

npx rom-mcp

Configuração do Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

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

Exemplo de uso

Pergunte ao Claude:

"Pesquise ROMs de Super Mario World no Internet Archive"

"Verifique este arquivo de ROM em ~/Downloads/game.sfc"

"Que jogo é este? MD5: a1b2c3d4e5f6..."

"Examine minha coleção de ROMs em ~/ROMs e me diga o que tenho"

"Baixe a ROM do Sonic the Hedgehog para minha área de trabalho"

"Analise este arquivo de save e me diga quanto tempo de jogo tenho"

Verificação de checksum

O servidor calcula hashes MD5 e SHA1 de arquivos de ROM e os verifica em relação aos bancos de dados conhecidos para confirmar a integridade e identificar jogos.

Suporte a arquivos de save

Analisa formatos comuns de save de emuladores, incluindo arquivos .srv, .srm, .sav, .states e .ss.

Licença

MIT