Merge branch 'main' into dev

Author: bluddy

.github/workflows/build.yml

@@ -10,8 +10,8 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      GHIDRA_VERSION: 11.3.2
-      GHIDRA_DATE: 20250415
+      GHIDRA_VERSION: 11.4.1
+      GHIDRA_DATE: 20250731
       GHIDRA_LIBS: >-
         Features/Base/lib/Base.jar
         Features/Decompiler/lib/Decompiler.jar

README.md

@@ -11,7 +11,7 @@
 
 
 # ghidraMCP
-ghidraMCP is an Model Context Protocol server for allowing LLMs to autonomously reverse engineer applications. It exposes numerous tools from core Ghidra functionality to MCP clients.
+ghidraMCP is a Model Context Protocol server for allowing LLMs to autonomously reverse engineer applications. It exposes numerous tools from core Ghidra functionality to MCP clients.
 
 https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9
 

build.gradle

@@ -0,0 +1,159 @@
+plugins {
+    id 'java'
+    id 'application'
+}
+
+// Extension properties
+ext.GHIDRA_INSTALL_DIR = findProperty('GHIDRA_INSTALL_DIR') ?: System.env.GHIDRA_INSTALL_DIR ?: '/path/to/ghidra'
+
+// Java version compatibility
+java {
+    sourceCompatibility = JavaVersion.VERSION_21
+    targetCompatibility = JavaVersion.VERSION_21
+}
+
+repositories {
+    mavenCentral()
+}
+
+configurations {
+    ghidraRuntime
+}
+
+dependencies {
+    // External dependencies
+    implementation 'org.reflections:reflections:0.10.2'
+    implementation 'com.google.code.gson:gson:2.10.1'
+    
+    // Ghidra dependencies (from lib directory)
+    implementation fileTree(dir: 'lib', include: '*.jar')
+    
+    // Test dependencies
+    testImplementation 'junit:junit:4.13.2'
+}
+
+// Compile with specific settings
+compileJava {
+    options.compilerArgs += ['-Xlint:-options']
+    options.encoding = 'UTF-8'
+}
+
+// Create the main JAR
+jar {
+    archiveBaseName = 'GhidraMCP'
+    archiveVersion = '1.0-SNAPSHOT'
+    archiveClassifier = ''
+    
+    from sourceSets.main.output
+    
+    // Include only our compiled classes, not Ghidra JARs
+    exclude '**/App.class'
+    
+    // Set manifest
+    manifest {
+        from 'src/main/resources/META-INF/MANIFEST.MF'
+    }
+}
+
+// Task to copy Ghidra JARs from installation
+task copyGhidraJars(type: Copy) {
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/Generic/lib/Generic.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar"  
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/Project/lib/Project.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/Docking/lib/Docking.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/Utility/lib/Utility.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Framework/Gui/lib/Gui.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Features/Base/lib/Base.jar"
+    from "${GHIDRA_INSTALL_DIR}/Ghidra/Features/Decompiler/lib/Decompiler.jar"
+    
+    into 'lib'
+    
+    doFirst {
+        println "Copying Ghidra JARs from: ${GHIDRA_INSTALL_DIR}"
+    }
+}
+
+// Task to create the extension zip
+task createExtension(type: Zip, dependsOn: jar) {
+    archiveBaseName = 'GhidraMCP'
+    archiveVersion = '1.0-SNAPSHOT'
+    archiveClassifier = ''
+    destinationDirectory = file('dist')
+    
+    from('src/main/resources') {
+        include 'extension.properties'
+        include 'Module.manifest'
+    }
+    
+    from jar.archiveFile
+    rename { 'lib/GhidraMCP.jar' }
+    
+    // Include external dependencies but exclude Ghidra JARs
+    from(configurations.runtimeClasspath) {
+        into 'lib'
+        exclude 'Generic-*.jar'
+        exclude 'SoftwareModeling-*.jar'
+        exclude 'Project-*.jar'
+        exclude 'Docking-*.jar'
+        exclude 'Utility-*.jar'
+        exclude 'Gui-*.jar'
+        exclude 'Base-*.jar'
+        exclude 'Decompiler-*.jar'
+        exclude '*.jar' // Exclude all JARs from lib directory
+    }
+    
+    // Include only specific non-Ghidra dependencies
+    from(configurations.runtimeClasspath.filter { 
+        it.name.contains('reflections') || it.name.contains('gson') 
+    }) {
+        into 'lib'
+    }
+}
+
+// Task to clean and build everything
+task buildExtension {
+    dependsOn 'clean', 'jar', 'createExtension'
+    description = 'Builds the complete Ghidra extension'
+    
+    doLast {
+        println ""
+        println "Extension built successfully!"
+        println "Output: ${file('dist/GhidraMCP-1.0-SNAPSHOT.zip').absolutePath}"
+        println ""
+        println "To install:"
+        println "1. Open Ghidra"
+        println "2. File -> Install Extensions"
+        println "3. Click '+' and select the zip file"
+        println "4. Restart Ghidra"
+    }
+}
+
+// Helper task to check if Ghidra JARs exist
+task checkGhidraJars {
+    doLast {
+        def requiredJars = [
+            'Generic.jar', 'SoftwareModeling.jar', 'Project.jar', 'Docking.jar',
+            'Utility.jar', 'Gui.jar', 'Base.jar', 'Decompiler.jar'
+        ]
+        
+        def missingJars = []
+        requiredJars.each { jar ->
+            if (!file("lib/${jar}").exists()) {
+                missingJars.add(jar)
+            }
+        }
+        
+        if (missingJars.isEmpty()) {
+            println "✓ All required Ghidra JARs found in lib/ directory"
+        } else {
+            println "✗ Missing Ghidra JARs in lib/ directory:"
+            missingJars.each { jar -> println "  - ${jar}" }
+            println ""
+            println "Run: gradle copyGhidraJars -PGHIDRA_INSTALL_DIR=/path/to/ghidra"
+            println "Or manually copy the JARs to lib/ directory"
+        }
+    }
+}
+
+// Make jar depend on checking Ghidra JARs
+jar.dependsOn checkGhidraJars