Add MCPinstaller and improve DMA device handling

MCPinstaller:
- Standalone GUI tool for configuring MCP clients
- Auto-detects Claude Desktop, Cursor, VS Code, and 8+ other clients
- Embedded mcp_bridge.js (no separate file needed)
- Extracts bridge to AppData/Orpheus on install
- Admin manifest for writing to various config directories

DMA improvements:
- Display actual device name (Enigma X1, ScreamerM2, etc.) in status bar
- Query FPGA device ID via VMMDLL_ConfigGet
- Fallback to generic "fpga" if device unknown

Other fixes:
- Fix F11 fullscreen toggle not working after first use
- Reset ImGui layout on fullscreen transitions for smoother experience
- Move runtime DLLs to AppData for persistent storage
- Update release workflow to include MCPinstaller.exe

Author: super2xl

.github/workflows/release.yml

@@ -30,6 +30,7 @@ jobs:
       run: |
         mkdir release
         copy build\bin\Release\orpheus.exe release\
+        copy build\bin\Release\MCPinstaller.exe release\
         copy LICENSE release\
         copy README.md release\
 

CMakeLists.txt

@@ -52,11 +52,13 @@ include(Dependencies)
 # Main Executable
 # ============================================================================
 
-# Collect source files
+# Collect source files (exclude installer directory)
 file(GLOB_RECURSE ORPHEUS_SOURCES
     "src/*.cpp"
     "src/**/*.cpp"
 )
+# Remove installer sources from main executable
+list(FILTER ORPHEUS_SOURCES EXCLUDE REGEX ".*installer.*")
 
 # Windows resource file (for .exe icon)
 if(WIN32)
@@ -132,11 +134,67 @@ elseif(PLATFORM_LINUX)
     )
 endif()
 
+# ============================================================================
+# MCPinstaller - Standalone MCP Bridge Installer
+# ============================================================================
+
+set(MCPINSTALLER_SOURCES
+    "src/installer/installer_main.cpp"
+    "src/installer/installer_app.cpp"
+)
+
+# Windows resource file (for .exe icon)
+if(WIN32)
+    set(MCPINSTALLER_RESOURCES "${CMAKE_SOURCE_DIR}/resources/orpheus.rc")
+endif()
+
+add_executable(MCPinstaller ${MCPINSTALLER_SOURCES} ${MCPINSTALLER_RESOURCES})
+
+target_include_directories(MCPinstaller PRIVATE
+    ${CMAKE_SOURCE_DIR}/src
+    ${CMAKE_SOURCE_DIR}/include
+    ${EMBEDDED_RESOURCE_INCLUDE_DIR}
+    ${JSON_INCLUDE_DIR}
+    ${STB_INCLUDE_DIR}
+)
+
+target_link_libraries(MCPinstaller PRIVATE
+    imgui
+    glfw
+)
+
+if(PLATFORM_WINDOWS)
+    target_link_libraries(MCPinstaller PRIVATE
+        opengl32
+    )
+
+    set_target_properties(MCPinstaller PROPERTIES
+        WIN32_EXECUTABLE TRUE
+    )
+
+    if(MSVC)
+        target_compile_options(MCPinstaller PRIVATE
+            /W4 /MP /utf-8
+        )
+        target_link_options(MCPinstaller PRIVATE
+            /ENTRY:mainCRTStartup
+            /MANIFESTUAC:level='requireAdministrator'
+        )
+        target_compile_definitions(MCPinstaller PRIVATE
+            _CRT_SECURE_NO_WARNINGS
+        )
+    endif()
+elseif(PLATFORM_LINUX)
+    target_link_libraries(MCPinstaller PRIVATE
+        dl pthread GL
+    )
+endif()
+
 # ============================================================================
 # Installation
 # ============================================================================
 
-install(TARGETS orpheus
+install(TARGETS orpheus MCPinstaller
     RUNTIME DESTINATION bin
 )
 

README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="resources/images/banner.png" alt="Orpheus" width="600">
+  <img src="resources/images/banner.png" alt="Orpheus" width="400">
 </p>
 
 <p align="center">
@@ -31,7 +31,9 @@ cmake ..
 cmake --build . --config Release
 ```
 
-Output: `build/bin/Release/orpheus.exe`
+Output:
+- `build/bin/Release/orpheus.exe` - Main application
+- `build/bin/Release/MCPinstaller.exe` - MCP client configuration tool (includes embedded bridge)
 
 ## Usage
 
@@ -45,24 +47,42 @@ orpheus.exe --connect
 
 ### MCP Integration
 
+#### Quick Setup (Recommended)
+
+Use **MCPinstaller** to automatically configure all your MCP clients:
+
 1. Start Orpheus and enable MCP server in settings
-2. Configure Claude Code to use the MCP bridge:
+2. Copy the API key from Orpheus (Settings > MCP > Copy API Key)
+3. Run `MCPinstaller.exe` (included in releases)
+4. Enter your Orpheus server URL and API key
+5. Select which clients to configure (Claude Desktop, Cursor, VS Code, etc.)
+6. Click Install - restart your MCP clients to apply
+
+MCPinstaller auto-detects and configures: Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, Cline, Roo Code, LM Studio, Zed, Amazon Q, Warp, and more.
+
+#### Manual Configuration
+
+Alternatively, manually add to your MCP client config (e.g., `~/.claude/claude_desktop_config.json`):
 
 ```json
 {
   "mcpServers": {
     "orpheus": {
       "command": "node",
-      "args": ["path/to/mcp_bridge.js"],
+      "args": ["C:/path/to/mcp_bridge.js"],
       "env": {
-        "ORPHEUS_MCP_URL": "http://localhost:8765",
-        "ORPHEUS_API_KEY": "your-api-key"
+        "ORPHEUS_MCP_URL": "http://192.168.1.100:8765",
+        "ORPHEUS_API_KEY": "oph_your_key_here"
       }
     }
   }
 }
 ```
 
+**Notes:**
+- `ORPHEUS_MCP_URL`: Use `localhost` if on the same machine, otherwise use the Orpheus server IP
+- `ORPHEUS_API_KEY`: Required - copy from Orpheus GUI
+
 ## Project Structure
 
 ```
@@ -73,6 +93,7 @@ orpheus/
 │   ├── emulation/     # Unicorn CPU emulator
 │   ├── dumper/        # Game-specific SDK dumpers
 │   ├── mcp/           # MCP server implementation
+│   ├── installer/     # MCPinstaller standalone tool
 │   ├── ui/            # ImGui application
 │   └── utils/         # Logging, bookmarks
 ├── cmake/             # CMake modules (dependencies, resource embedding)

cmake/EmbedResources.cmake

@@ -107,6 +107,19 @@ function(embed_all_dlls)
         message(STATUS "Icon not found (optional): ${ICON_FILE}")
     endif()
 
+    # Process MCP bridge script
+    set(MCP_BRIDGE_FILE "${CMAKE_SOURCE_DIR}/mcp_bridge.js")
+    set(HAS_MCP_BRIDGE FALSE)
+    if(EXISTS "${MCP_BRIDGE_FILE}")
+        set(output_file "${OUTPUT_DIR}/embedded_mcp_bridge.h")
+        embed_resource("${MCP_BRIDGE_FILE}" "${output_file}")
+        list(APPEND EMBEDDED_HEADERS "${output_file}")
+        set(HAS_MCP_BRIDGE TRUE)
+        message(STATUS "Embedded MCP bridge: mcp_bridge.js")
+    else()
+        message(WARNING "MCP bridge not found: ${MCP_BRIDGE_FILE}")
+    endif()
+
     # Generate a master header that includes all embedded resources
     set(MASTER_HEADER "${OUTPUT_DIR}/embedded_resources.h")
     file(WRITE "${MASTER_HEADER}"
@@ -155,13 +168,29 @@ function(embed_all_dlls)
     if(HAS_ICON)
         file(APPEND "${MASTER_HEADER}"
             "inline constexpr bool has_icon = true;\n"
-            "// orpheus_png and orpheus_png_size defined in embedded_orpheus_icon.h\n"
+            "// orpheus_png and orpheus_png_size defined in embedded_orpheus_icon.h\n\n"
         )
     else()
         file(APPEND "${MASTER_HEADER}"
             "inline constexpr bool has_icon = false;\n"
             "inline constexpr unsigned char orpheus_png[] = {0};  // Placeholder byte\n"
-            "inline constexpr size_t orpheus_png_size = 0;\n"
+            "inline constexpr size_t orpheus_png_size = 0;\n\n"
+        )
+    endif()
+
+    # MCP Bridge resource
+    if(HAS_MCP_BRIDGE)
+        file(APPEND "${MASTER_HEADER}"
+            "// MCP Bridge script\n"
+            "inline constexpr bool has_mcp_bridge = true;\n"
+            "// mcp_bridge_js and mcp_bridge_js_size defined in embedded_mcp_bridge.h\n"
+        )
+    else()
+        file(APPEND "${MASTER_HEADER}"
+            "// MCP Bridge script (not found)\n"
+            "inline constexpr bool has_mcp_bridge = false;\n"
+            "inline constexpr unsigned char mcp_bridge_js[] = {0};\n"
+            "inline constexpr size_t mcp_bridge_js_size = 0;\n"
         )
     endif()
 

mcp_bridge.js

@@ -13,10 +13,16 @@ const { URL } = require('url');
 // Configuration
 // ============================================================================
 
-const MCP_URL = process.env.ORPHEUS_MCP_URL || 'http://10.0.0.120:8765';
-const API_KEY = process.env.ORPHEUS_API_KEY || 'oph_cb3fe9a44d96ce8f4f87bc745dbbd50451c0c47b43c9c33ebb53d092d0e7c5c4';
+const MCP_URL = process.env.ORPHEUS_MCP_URL || 'http://localhost:8765';
+const API_KEY = process.env.ORPHEUS_API_KEY;
 const DEBUG = process.env.DEBUG === 'true';
 
+if (!API_KEY) {
+  console.error('Error: ORPHEUS_API_KEY environment variable is required');
+  console.error('Set it in your MCP server configuration or export it before running');
+  process.exit(1);
+}
+
 // ============================================================================
 // Request Queue (Serialization)
 // ============================================================================

src/core/dma_interface.cpp

@@ -151,6 +151,33 @@ using FN_ScatterExecute = BOOL(*)(void*);
 using FN_ScatterRead = BOOL(*)(void*, ULONG64, DWORD, PBYTE, PDWORD);
 using FN_ScatterCloseHandle = void(*)(void*);
 using FN_ConfigSet = BOOL(*)(void*, ULONG64, ULONG64);
+using FN_ConfigGet = BOOL(*)(void*, ULONG64, PULONG64);
+using FN_VfsReadU = DWORD(*)(void*, LPCSTR, PBYTE, DWORD, PDWORD, ULONG64);
+
+// LeechCore FPGA option to get device ID
+static constexpr ULONG64 LC_OPT_FPGA_FPGA_ID = 0x0300008100000000ULL;
+
+// FPGA Device ID to friendly name mapping (from LeechCore device_fpga.c)
+static const char* GetFPGADeviceName(uint64_t device_id) {
+    switch (device_id) {
+        case 0x00: return "SP605 / FT601";
+        case 0x01: return "PCIeScreamer R1";
+        case 0x02: return "AC701 / FT601";
+        case 0x03: return "PCIeScreamer R2";
+        case 0x04: return "ScreamerM2";
+        case 0x05: return "NeTV2 RawUDP";
+        case 0x08: return "FT2232H";
+        case 0x09: return "Enigma X1";
+        case 0x0A: return "Enigma X2";
+        case 0x0B: return "ScreamerM2x4";
+        case 0x0C: return "PCIeSquirrel";
+        case 0x0D: return "Device #13N";
+        case 0x0E: return "Device #14T";
+        case 0x0F: return "Device #15N";
+        case 0x10: return "Device #16T";
+        default:   return nullptr;  // Unknown device
+    }
+}
 
 // VMM config options for refresh
 static constexpr ULONG64 OPT_REFRESH_ALL = 0x2001ffff;
@@ -174,6 +201,8 @@ static FN_ScatterExecute fn_ScatterExecute = nullptr;
 static FN_ScatterRead fn_ScatterRead = nullptr;
 static FN_ScatterCloseHandle fn_ScatterClose = nullptr;
 static FN_ConfigSet fn_ConfigSet = nullptr;
+static FN_ConfigGet fn_ConfigGet = nullptr;
+static FN_VfsReadU fn_VfsReadU = nullptr;
 
 static void* vmm_module = nullptr;
 
@@ -207,6 +236,8 @@ static bool LoadVMMFunctions() {
     fn_ScatterRead = LoadFunction<FN_ScatterRead>("VMMDLL_Scatter_Read");
     fn_ScatterClose = LoadFunction<FN_ScatterCloseHandle>("VMMDLL_Scatter_CloseHandle");
     fn_ConfigSet = LoadFunction<FN_ConfigSet>("VMMDLL_ConfigSet");
+    fn_ConfigGet = LoadFunction<FN_ConfigGet>("VMMDLL_ConfigGet");
+    fn_VfsReadU = LoadFunction<FN_VfsReadU>("VMMDLL_VfsReadU");
 
     return fn_Initialize && fn_Close && fn_MemFree && fn_PidList && fn_ProcessGetInfo && fn_MemRead;
 }
@@ -269,13 +300,27 @@ bool DMAInterface::Initialize(const std::string& device) {
         ReportError("VMMDLL_Initialize failed for device: " + device);
         return false;
     }
+
+    // Try to get the actual FPGA device name via ConfigGet
+    device_type_ = device;  // Fallback to device string (e.g., "fpga")
+    if (fn_ConfigGet && device == "fpga") {
+        ULONG64 fpga_id = 0;
+        if (fn_ConfigGet(vmm_handle_, LC_OPT_FPGA_FPGA_ID, &fpga_id)) {
+            const char* name = GetFPGADeviceName(fpga_id);
+            if (name) {
+                device_type_ = name;
+            }
+        }
+    }
+
     return true;
 }
 
 void DMAInterface::Close() {
     if (vmm_handle_ != nullptr && fn_Close != nullptr) {
         fn_Close(vmm_handle_);
         vmm_handle_ = nullptr;
+        device_type_.clear();
     }
 }
 

src/core/dma_interface.h

@@ -98,6 +98,11 @@ class DMAInterface {
      */
     [[nodiscard]] bool IsConnected() const { return vmm_handle_ != nullptr; }
 
+    /**
+     * Get the device type string (e.g., "fpga", "file://...")
+     */
+    [[nodiscard]] const std::string& GetDeviceType() const { return device_type_; }
+
     // =========================================================================
     // Process Operations
     // =========================================================================
@@ -241,6 +246,7 @@ class DMAInterface {
     void ReportError(const std::string& message);
 
     VMMHandle vmm_handle_ = nullptr;
+    std::string device_type_;
     std::string last_error_;
     std::function<void(const std::string&)> error_callback_;
 };