Skip to main content
Glama

Xbox Port MCP

English · Configuración · Contribuir

MCP independiente para inspeccionar juegos de Xbox original y coordinar ports para Windows mediante perfiles específicos. Automatiza pasos repetibles del trabajo realizado con Los Sims toman la calle. No convierte cualquier ISO en un juego nativo: necesita un proyecto de recompilación y correcciones para cada título y revisión.

Estado 0.1.0: experimental

Un perfil incluido: sims-bustin-out-usa. Usa bustinout-recomp y XboxXBERecomp, fijados por commit.

El flujo manual original produjo un juego que su usuario confirmó jugable dentro de una casa, con guardado, textos originales en español e instalador funcional. Esta MCP es una implementación nueva de ese flujo: tiene pruebas de protocolo, lectores, rutas, trabajos y empaquetado. Todavía no se ha repetido una compilación completa del juego de principio a fin mediante esta MCP. La confirmación histórica se distingue de las pruebas de esta versión.

El perfil selecciona los recursos españoles presentes en el juego. La traducción del panel adicional de ajustes de PC no está incluida en esta receta. El instalador está en español. Los Sims conservan su idioma ficticio.

Related MCP server: dspre

Funciones

  • Inspección ISO XDVDFS y XBE, identidad y huellas; extracción sin ejecutar el juego.

  • Rechazo de revisiones desconocidas antes de aplicar correcciones de direcciones.

  • Fuentes fijadas, correcciones de almacenamiento/idioma y configuración/compilación.

  • Imágenes del instalador generadas desde vídeos de la copia local, instalador e ISO para Windows.

  • Verificación del instalador dentro de la ISO y registro separado de observaciones humanas.

No incluye juegos, BIOS, claves, recursos comerciales, capturas, partidas ni ejecutables de juegos recompilados. Cada usuario aporta sus archivos localmente. REA puede ayudar a investigar perfiles nuevos; no es una dependencia obligatoria ni sustituye la implementación de un port.

Instalar

Python 3.11 o posterior. Desde una copia del repositorio:

python -m venv .venv
.venv\Scripts\python -m pip install .

En Linux/macOS usa .venv/bin/python. En esos sistemas solo se ofrece inspección/extracción; la receta de compilación y empaquetado actual está orientada a Windows x64.

Añade el servidor stdio a tu cliente MCP siguiendo examples/mcp.json. Sustituye las rutas por rutas absolutas reales. El comando es el Python de esa instalación y los argumentos son -m xbox_port_mcp.

Inspeccionar/extraer no requiere compiladores. Construir requiere Git, CMake, Ninja, LLVM compatible y entorno MSVC x64; empaquetar añade FFmpeg, Inno Setup, redistribuibles x64 y Windows PowerShell/IMAPI. La MCP no instala estas herramientas. Véase configuración.

Flujo

  1. Llama a doctor, list_profiles e inspect_iso y verifica la identidad exacta.

  2. Usa create_workspace con profile_id="sims-bustin-out-usa" y language="es".

  3. Llama a start_step en orden: extract (con input_path), prepare, configure, compile. Preparar/configurar ya aplican fixes, también disponible por separado.

  4. Consulta get_job hasta terminar cada trabajo. Detén pasos dependientes ante fallos; cancel_job cancela trabajos propios.

  5. Prueba manualmente el ejecutable: menú, casa y guardar/cargar. record_manual_observation registra solo resultados comunicados por el usuario.

  6. Continúa con artwork, installer, iso, verify_iso, y prueba instalar y abrir el resultado.

Son nueve herramientas, el recurso xbox-port://profiles y el prompt port_workflow. Ejecutar programas está desactivado por defecto. Un trabajo succeeded confirma ese paso, no la jugabilidad.

Desarrollo

python -m pip install ".[dev]"
python -m pytest -q
python -m pip wheel . --no-deps --wheel-dir dist

Las pruebas usan archivos sintéticos. La configuración CI incluye Windows y Ubuntu; eso no equivale a comprobar un juego completo. Código propio bajo MIT; véase atribuciones.

Available Tools

9 tools
cancel_jobA

Request cancellation of a job owned by this server session, never an arbitrary PID.

Inputs: job_id (required). Returns: object

create_workspaceB

Create a new isolated workspace; no source checkout, extraction or execution occurs.

Inputs: profile_id (required), language. Returns: object

doctorA
Read-only

Report local tool availability and execution/network opt-ins. Does not install anything.

Inputs: no named parameters. Returns: object

get_jobB
Read-only

Get process result and at most 16 KiB of log tail. A succeeded step is not playability evidence.

Inputs: job_id (required). Returns: object

inspect_isoA
Read-only

Read an allowed local XDVDFS ISO; return bounded entries and XBE identity, without extracting.

Inputs: path (required), limit, offset. Returns: object

inspect_xbeB
Read-only

Inspect an allowed original Xbox XBE and match its exact identity to a profile.

Inputs: path (required). Returns: object

list_profilesB
Read-only

List supported game profiles and precisely labelled historical evidence.

Inputs: no named parameters. Returns: result

record_manual_observationA

Record a client-reported human observation separately from automated job evidence. Only call when the user has supplied that observation. This does not independently verify it.

Inputs: note (required), check (required), outcome (required), workspace_id (required). Returns: object

start_stepA
Destructive

Start a fixed profile step, never arbitrary shell text. extract needs an allowed ISO input_path. Other steps: prepare, fixes, configure, compile, artwork, installer, iso, verify_iso. Prepare downloads pinned trusted sources; builds may download dependencies when enabled. External steps require XBOX_PORT_ALLOW_EXECUTION=1. Returns a job id, not a completion claim.

Inputs: step (required), workspace_id (required), input_path. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: profile listing, job lifecycle (start/get/cancel), evidence recording, environment diagnostics, ISO/XBE inspection, and workspace creation. There is no meaningful overlap between inspection, execution, and observation tools.

    Naming Consistency4/5

    Eight of nine tools follow a clear snake_case verb_noun pattern (list_profiles, get_job, cancel_job, inspect_iso, create_workspace, start_step, etc.). The lone exception is 'doctor', which breaks the pattern but is a conventional and readable diagnostic name.

    Tool Count5/5

    Nine tools is well-scoped for an Xbox porting workflow that must separate job execution, evidence collection, inspection, and environment checks. Each tool has a clear role and none appear redundant.

    Completeness4/5

    Core lifecycle coverage exists: profiles can be listed, jobs started/retrieved/cancelled, workspaces created, and artifacts inspected. Minor gaps include no workspace listing/deletion and no explicit job listing, but agents can likely work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables a portable Windows coding agent to perform file editing, process management, package operations, testing, and Git workflows within configured project boundaries. Also provides managed background process sessions and Git linked worktree management.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an agent to edit the contents of a Pokémon Gen IV Nintendo DS ROM (Diamond, Pearl, Platinum, HeartGold, SoulSilver) conversationally — extracting a .nds into a project folder, changing game data such as trainer parties and map events, and repacking it — rather than clicking through a GUI editor. It also handles first-run setup of the required extract/repack binary and can point at an existing DSPRE installation.
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI coding agents to reverse engineer an operating system from its ISO and rebuild it component by component, exposing 39 tools over stdio for ISO fingerprinting, sandboxed QEMU VM lifecycle, PE analysis, API-surface dumps, syscall tracing, behavior diffs, component scaffolding, compat shims, app-compat testing, and knowledge-base search. It lets an agent survey a reference OS, generate clean-room specs and code, boot the rebuild, and test real applications against it.
      39
      MIT