[mcp] New tool to list the most recent media

Author: drhelius

MCP_README.md

@@ -323,6 +323,7 @@ The server exposes tools organized in the following categories:
 
 ### Media & State Management
 - `get_media_info` - Get loaded ROM/CD info
+- `list_recent_media` - List the 10 most recent ROM files or CD-ROM images opened by Geargrafx
 - `load_media` - Load ROM file or CD-ROM image (.pce, .sgx, .hes, .cue, .zip). Automatically loads .sym symbol file if present
 - `load_bios` - Load a BIOS file for CD-ROM emulation. Two types: 'syscard' (System Card, 256KB) and 'gameexpress' (Game Express, 32KB)
 - `load_symbols` - Load debug symbols from file (.sym format with 'BANK:ADDRESS LABEL' entries)

platforms/shared/desktop/config.cpp

@@ -206,6 +206,29 @@ void config_load_defaults(void)
     config_write();
 }
 
+void config_push_recent_media(const std::string& path)
+{
+    if (path.empty())
+        return;
+
+    int slot = 0;
+    for (slot = 0; slot < config_max_recent_roms; slot++)
+    {
+        if (config_emulator.recent_roms[slot].compare(path) == 0)
+            break;
+    }
+
+    if (slot >= config_max_recent_roms)
+        slot = config_max_recent_roms - 1;
+
+    for (int index = slot; index > 0; index--)
+    {
+        config_emulator.recent_roms[index] = config_emulator.recent_roms[index - 1];
+    }
+
+    config_emulator.recent_roms[0] = path;
+}
+
 void config_read(void)
 {
     if (!config_ini_file->read(config_ini_data))

platforms/shared/desktop/config.h

@@ -310,6 +310,7 @@ EXTERN void config_destroy(void);
 EXTERN void config_read(void);
 EXTERN void config_write(void);
 EXTERN void config_load_defaults(void);
+EXTERN void config_push_recent_media(const std::string& path);
 EXTERN void config_update_hotkey_string(config_Hotkey* hotkey);
 
 #undef CONFIG_IMPORT

platforms/shared/desktop/gui.cpp

@@ -52,7 +52,6 @@ static bool loading_rom_active = false;
 static char loading_rom_path[4096] = "";
 static bool loading_physical_cdrom = false;
 static void main_window(void);
-static void push_recent_rom(std::string path);
 static void show_status_message(void);
 static void show_error_window(void);
 static void show_loading_popup(void);
@@ -445,7 +444,7 @@ void gui_load_rom(const char* path)
     loading_physical_cdrom = false;
 
     gui_debug_auto_save_settings();
-    push_recent_rom(path);
+    config_push_recent_media(path);
     emu_resume();
 
     strncpy(loading_rom_path, path, sizeof(loading_rom_path) - 1);
@@ -638,27 +637,6 @@ static void main_window(void)
     ImGui::PopStyleVar();
 }
 
-static void push_recent_rom(std::string path)
-{
-    int slot = 0;
-    for (slot = 0; slot < config_max_recent_roms; slot++)
-    {
-        if (config_emulator.recent_roms[slot].compare(path) == 0)
-        {
-            break;
-        }
-    }
-
-    slot = MIN(slot, config_max_recent_roms - 1);
-
-    for (int i = slot; i > 0; i--)
-    {
-        config_emulator.recent_roms[i] = config_emulator.recent_roms[i - 1];
-    }
-
-    config_emulator.recent_roms[0] = path;
-}
-
 static void show_status_message(void)
 {
     if (status_message_active)

platforms/shared/desktop/mcp/mcp_debug_adapter.cpp

@@ -59,6 +59,16 @@ static void get_mouse_motion_delta(const std::string& button, int* delta_x, int*
         *delta_x = k_mcp_mouse_motion_step;
 }
 
+static std::string get_file_name_from_path(const std::string& path)
+{
+    size_t position = path.find_last_of("/\\");
+
+    if (position == std::string::npos)
+        return path;
+
+    return path.substr(position + 1);
+}
+
 struct DisassemblerBookmark
 {
     u16 address;
@@ -675,6 +685,31 @@ json DebugAdapter::GetMediaInfo()
     return info;
 }
 
+json DebugAdapter::ListRecentMedia()
+{
+    json result;
+    json recent_media = json::array();
+
+    for (int index = 0; index < config_max_recent_roms; index++)
+    {
+        const std::string& path = config_emulator.recent_roms[index];
+
+        if (path.empty())
+            continue;
+
+        json entry;
+        entry["index"] = index;
+        entry["file_path"] = path;
+        entry["file_name"] = get_file_name_from_path(path);
+        recent_media.push_back(entry);
+    }
+
+    result["count"] = recent_media.size();
+    result["recent_media"] = recent_media;
+
+    return result;
+}
+
 json DebugAdapter::GetHuC6280Status()
 {
     json status;
@@ -1449,6 +1484,8 @@ json DebugAdapter::LoadMedia(const std::string& file_path)
     result["is_cdrom"] = m_core->GetMedia()->IsCDROM();
     result["is_sgx"] = m_core->GetMedia()->IsSGX();
 
+    config_push_recent_media(file_path);
+
     return result;
 }
 

platforms/shared/desktop/mcp/mcp_debug_adapter.h

@@ -139,6 +139,7 @@ class DebugAdapter
 
     // Media and state management
     json GetMediaInfo();
+    json ListRecentMedia();
     json LoadMedia(const std::string& file_path);
     json LoadBios(const std::string& file_path, bool syscard);
     json ListSaveStateSlots();

platforms/shared/desktop/mcp/mcp_server.cpp

@@ -551,6 +551,17 @@ void McpServer::HandleToolsList(const json& request)
         }}
     });
 
+    tools.push_back({
+        {"name", "list_recent_media"},
+        {"title", "List Recent Media"},
+        {"description", "List the 10 most recent ROMs or CD-ROM images opened by Geargrafx. Use file_path from an entry with load_media to reopen it"},
+        {"inputSchema", {
+            {"type", "object"},
+            {"properties", json::object()},
+            {"additionalProperties", false}
+        }}
+    });
+
     // Chip status tools
     tools.push_back({
         {"name", "get_huc6280_status"},
@@ -1862,6 +1873,10 @@ json McpServer::ExecuteCommand(const std::string& toolName, const json& argument
     {
         return m_debugAdapter.GetMediaInfo();
     }
+    else if (normalizedTool == "list_recent_media")
+    {
+        return m_debugAdapter.ListRecentMedia();
+    }
     // Chip status
     else if (normalizedTool == "get_huc6280_status")
     {