convez.ai
MCP ServerIntegração & APIsIntermediário
lodordev

MCP RomM — Gerenciador de Biblioteca de Jogos Retrô

lodordev/mcp-romm

Navegue e gerencie sua biblioteca de jogos retrô via IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra Claude com RomM, um gerenciador self-hosted de bibliotecas de jogos retrô. Oferece 19 ferramentas read-only para navegar plataformas, buscar ROMs, gerenciar coleções e acompanhar metadados através de qualquer assistente IA compatível com MCP.

Instalação

$npx convez-ai lodordev/mcp-romm

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
v1.2.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar bibliotecas de ROMs por plataforma ou gênero
  • Buscar e identificar jogos por nome ou hash de arquivo
  • Gerenciar coleções e acompanhar status de jogabilidade (backlog, concluído, etc)
  • Monitorar salvamentos e metadados de ROMs através de conversas naturais
  • Integrar consultas de RomM em fluxos de automação com Claude

Veredito

Servidor MCP bem construído para quem mantém RomM self-hosted e quer consultar a biblioteca via Claude. Implementação limpa com 19 ferramentas read-only cobrindo casos de uso reais (busca, coleções, metadados), mas nicho específico em usuários de emulação organizada.

README

A tradução para o português deste README ainda está na fila.

RomM MCP Server

An MCP server for RomM — the self-hosted retro game library manager. 19 read-only tools for browsing platforms, searching ROMs, viewing metadata, managing collections, tracking saves, and monitoring tasks through any MCP-compatible AI assistant.

Tools

ToolDescription
romm_statusCheck server configuration and reachability
romm_statsLibrary-wide statistics (platforms, ROMs, saves, total size)
romm_platformsList platforms with ROM counts and sizes
romm_library_itemsBrowse ROMs with filtering and pagination
romm_recentRecently added or updated ROMs
romm_get_itemFull ROM detail — metadata, saves, user status
romm_searchSearch ROMs by name
romm_search_by_hashIdentify a ROM by file hash (CRC, MD5, or SHA1)
romm_filtersAvailable filter values (genres, regions, languages, tags)
romm_collectionsList user-curated collections
romm_collection_detailList ROMs in a specific collection
romm_smart_collectionsList auto-generated smart collections
romm_savesList save files by ROM or platform
romm_user_profileBrowse by status (now playing, backlog, completed, etc.)
romm_rom_notesView notes on a ROM
romm_firmwareList BIOS/firmware files per platform
romm_devicesList registered devices
romm_tasksCheck running/scheduled task status
romm_scan_libraryTrigger a background library rescan

Setup

Prerequisites

  • Python 3.10+
  • A running RomM instance (v4.0+)
  • A RomM user account with admin role

Install

pip install fastmcp httpx

Or clone and install:

git clone https://github.com/lodordev/mcp-romm.git
cd mcp-romm
pip install .

Configure

Set environment variables:

VariableRequiredDefaultDescription
ROMM_URLNohttp://localhost:3000Your RomM instance URL
ROMM_USERNAMEYesRomM username
ROMM_PASSWORDYesRomM password
ROMM_REQUEST_TIMEOUTNo30Default request timeout (seconds)
ROMM_REQUEST_TIMEOUT_LONGNo60Timeout for slow endpoints
ROMM_TLS_VERIFYNotrueVerify TLS certificates

Add to Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "romm": {
      "command": "python",
      "args": ["/path/to/mcp-romm/server.py"],
      "env": {
        "ROMM_URL": "http://your-romm-instance:3000",
        "ROMM_USERNAME": "your-username",
        "ROMM_PASSWORD": "your-password"
      }
    }
  }
}

Add to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "romm": {
      "command": "python",
      "args": ["/path/to/mcp-romm/server.py"],
      "env": {
        "ROMM_URL": "http://your-romm-instance:3000",
        "ROMM_USERNAME": "your-username",
        "ROMM_PASSWORD": "your-password"
      }
    }
  }
}

Examples

Once configured, you can ask your AI assistant things like:

  • "What platforms do I have in RomM?"
  • "Search for Zelda games"
  • "Show me my backlog"
  • "How many ROMs do I have total?"
  • "What was recently added?"
  • "Show me the saves for Super Metroid"
  • "What's in my favorites?"
  • "List my firmware files for PlayStation"
  • "What tasks are running?"
  • "What devices are registered?"

Security

  • Read-only. All 19 tools are read-only. The only mutation is romm_scan_library, which triggers an idempotent library rescan.
  • No disk writes. Credentials and tokens are held in memory only, never written to disk.
  • Scoped tokens. OAuth2 tokens request only the scopes needed for read operations.
  • TLS by default. Certificate verification is enabled by default (ROMM_TLS_VERIFY=true).
  • Auto-retry. If a token expires mid-session, the server re-authenticates transparently.

Auth

The server uses OAuth2 password grant to authenticate with RomM. Tokens are scoped to the minimum permissions needed and automatically refreshed when they expire. If a request gets a 401, the server re-authenticates and retries once.

Note: Your RomM user must have the admin role for all tools to work. The user must also be enabled in the RomM admin panel.

License

MIT

Ver o original no GitHub

Bom para

Relacionados