dejared-mcp 0.1.4 → 1.0.0

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "dejared",
       "source": "./",
       "description": "Explore, analyze, and decompile Java JAR files with structured workflows.",
-      "version": "0.1.4",
+      "version": "1.0.0",
       "author": {
         "name": "HuynhKhanh1402"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "dejared",
   "description": "Explore, analyze, and decompile Java JAR files with structured workflows.",
-  "version": "0.1.4",
+  "version": "1.0.0",
   "author": {
     "name": "HuynhKhanh1402"
   },

package/README.md

@@ -1,7 +1,7 @@
 [![npm version](https://img.shields.io/npm/v/dejared-mcp?style=flat-square)](https://www.npmjs.com/package/dejared-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933?style=flat-square&logo=node.js&logoColor=white)]()
-[![Java](https://img.shields.io/badge/Java-21%2B-ED8B00?style=flat-square&logo=openjdk&logoColor=white)]()
+[![Java](https://img.shields.io/badge/Java-17%2B-ED8B00?style=flat-square&logo=openjdk&logoColor=white)]()
 
 # dejared-mcp
 
@@ -41,7 +41,7 @@ transport.
 ## Prerequisites
 
 - **Node.js** 18 or later
-- **Java** 21 or later (JRE is sufficient)
+- **Java** 17 or later (JRE is sufficient)
 
 ## Quick Start
 
@@ -358,7 +358,7 @@ If you prefer to run the server JAR directly without Node.js:
 
 2. Run it:
    ```bash
-   java -jar dejared-mcp-0.1.3.jar
+   java -jar dejared-mcp-0.2.0.jar
    ```
 
 3. Configure your MCP client to use the JAR directly instead of `npx`:
@@ -368,7 +368,7 @@ If you prefer to run the server JAR directly without Node.js:
      "mcpServers": {
        "dejared": {
          "command": "java",
-         "args": ["-jar", "/path/to/dejared-mcp-0.1.3.jar"]
+         "args": ["-jar", "/path/to/dejared-mcp-0.2.0.jar"]
        }
      }
    }
@@ -437,7 +437,7 @@ tool. The default timeout is 30 seconds and can be adjusted via
 
 **Q: Which Java version do I need?**
 
-Java 21 or later. A JRE is sufficient; you do not need a full JDK.
+Java 17 or later. A JRE is sufficient; you do not need a full JDK.
 
 **Q: Can I run the server without Node.js?**
 

package/lib/jar-runner.js

@@ -138,9 +138,20 @@ async function run() {
   const javaPath = resolveJava();
   await ensureJar();
 
-  const child = spawn(javaPath, ["-jar", JAR_PATH], {
-    stdio: "inherit",
-  });
+  const logDir = process.env.DEJARED_LOG_DIR || path.join(CACHE_DIR, "logs");
+  fs.mkdirSync(logDir, { recursive: true });
+
+  const jvmArgs = [`-Ddejared.log.dir=${logDir}`];
+
+  if (process.env.DEJARED_LOG_LEVEL) {
+    jvmArgs.push(`-Ddejared.log.level=${process.env.DEJARED_LOG_LEVEL}`);
+  }
+
+  const child = spawn(
+    javaPath,
+    [...jvmArgs, "-jar", JAR_PATH, "--spring.profiles.active=file-logging"],
+    { stdio: "inherit" },
+  );
 
   child.on("error", (err) => {
     log(`Failed to start Java: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dejared-mcp",
-  "version": "0.1.4",
+  "version": "1.0.0",
   "mcpName": "io.github.HuynhKhanh1402/dejared",
   "description": "Explore, analyze, and decompile Java JAR files via MCP",
   "bin": {

package/skills/jar-analysis/SKILL.md

@@ -15,7 +15,7 @@ description: >
 | `dejared_list_packages` | Cheap | List all packages with class counts |
 | `dejared_list_classes` | Cheap | List classes in a package (`recursive=true` for sub-packages) |
 | `dejared_list_resources` | Cheap | List all non-class resource files with sizes |
-| `dejared_read_resource` | Cheap | Read a resource file (yml, properties, xml, json, txt, sql, conf) |
+| `dejared_read_resource` | Cheap | Read a text resource file from inside a JAR (content-based detection, no extension restrictions) |
 | `dejared_dump_package_metadata` | Cheap | Batch metadata for multiple packages at once (annotations, fields, methods via ASM) |
 | `dejared_get_metadata` | Cheap | Single class metadata (ASM-based, no decompilation) |
 | `dejared_search_class` | Cheap | Find classes by name keyword (case-insensitive) |
@@ -25,7 +25,7 @@ description: >
 ## Shared Rules
 
 - All tool calls require the **absolute path** to the JAR file.
-- NEVER decompile a class without checking its metadata first.
+- Check metadata before decompiling — it often provides enough information without the cost of full decompilation.
 - Default decompiler: CFR. If output is broken, try `vineflower` or `procyon`.
 - Report results in structured format.
 
@@ -33,21 +33,21 @@ description: >
 
 ## Quick Use Cases
 
-**Quick Lookup** - find a class by name (`dejared_search_class`) or find a string in bytecode (`dejared_search_string`). One call, done.
+**Quick Lookup** — find a class by name (`dejared_search_class`) or find a string in bytecode (`dejared_search_string`). One call, done.
 
-**Read Config** - `dejared_list_resources` to see what's in the JAR, then `dejared_read_resource` to read it (application.yml, pom.xml, logback.xml, etc.)
+**Read Config** — `dejared_list_resources` to see what's in the JAR, then `dejared_read_resource` to read it (application.yml, pom.xml, logback.xml, etc.).
 
-**Get Signatures** - `dejared_get_metadata` for a single class, or `dejared_dump_package_metadata` for an entire package (accepts a list). Returns class hierarchy, annotations, fields, and method signatures without decompiling.
+**Get Signatures** — `dejared_get_metadata` for a single class, or `dejared_dump_package_metadata` for an entire package (accepts a list). Returns class hierarchy, annotations, fields, and method signatures without decompiling.
 
 ---
 
 ## Workflows
 
-**Explore** - top-down JAR mapping:
-`dejared_list_packages` → `dejared_list_classes` (use `recursive=true`) → `dejared_list_resources` → `dejared_read_resource` for configs → `dejared_dump_package_metadata` (batch all important packages in one call) → selective `dejared_decompile_class` only where method body logic is needed.
+**Explore** — top-down JAR mapping:
+`dejared_list_packages` → `dejared_list_classes` (use `recursive=true`) → `dejared_list_resources` → `dejared_read_resource` for configs → `dejared_dump_package_metadata` (batch all important packages in one call) → selective `dejared_decompile_class` only where method body logic is needed. If CFR output has issues, retry with `vineflower` or `procyon`.
 
-**Hunt** - search-driven investigation:
-Pick search tool (`dejared_search_class` or `dejared_search_string`) → triage results → `dejared_get_metadata` on promising matches → `dejared_decompile_class` only if needed. Never skip the metadata step.
+**Hunt** — search-driven investigation:
+Pick search tool (`dejared_search_class` or `dejared_search_string`) → triage results → `dejared_get_metadata` on promising matches → `dejared_decompile_class` only if needed.
 
-**Deep Analysis** - single class investigation:
+**Deep Analysis** — single class investigation:
 `dejared_get_metadata` first → `dejared_decompile_class` (CFR default) → cross-reference with `dejared_search_class` or `dejared_dump_package_metadata` if needed. If CFR output has issues (broken lambdas, `goto` statements, missing method bodies), retry with `vineflower` (best for modern Java features like records, sealed classes, pattern matching) or `procyon` (handles some obfuscated/edge-case bytecode better).