dejared-mcp 0.1.0 → 0.1.1

package/README.md

@@ -70,7 +70,10 @@ If Java is not in your system PATH, set the `DEJARED_JAVA_PATH` environment vari
 ## How It Works
 
 The npm package is a thin Node.js wrapper. On first run it:
-1. Checks `~/.dejared-mcp/` for a cached JAR matching the current version
+1. Checks the platform cache directory for a cached JAR matching the current version
+   - Linux: `$XDG_CACHE_HOME/dejared-mcp` (default `~/.cache/dejared-mcp`)
+   - macOS: `~/Library/Caches/dejared-mcp`
+   - Windows: `%LOCALAPPDATA%\dejared-mcp`
 2. Downloads the JAR from GitHub Releases if not cached
 3. Spawns `java -jar` with stdio inherited for MCP transport
 

package/lib/jar-runner.js

@@ -1,3 +1,9 @@
+/**
+ * JAR runner for dejared-mcp.
+ *
+ * Downloads the matching JAR from GitHub Releases into a platform-specific
+ * cache directory, then launches it with the locally available Java runtime.
+ */
 "use strict";
 
 const { spawn, execFileSync } = require("node:child_process");
@@ -9,7 +15,32 @@ const os = require("node:os");
 const PACKAGE = require(path.join(__dirname, "..", "package.json"));
 const JAR_VERSION = PACKAGE.version;
 const JAR_NAME = `dejared-mcp-${JAR_VERSION}.jar`;
-const CACHE_DIR = path.join(os.homedir(), ".dejared-mcp");
+
+/**
+ * Returns the platform-specific cache directory for storing downloaded JARs.
+ *   - Linux/BSD : $XDG_CACHE_HOME/dejared-mcp  (default ~/.cache/dejared-mcp)
+ *   - macOS     : ~/Library/Caches/dejared-mcp
+ *   - Windows   : %LOCALAPPDATA%\dejared-mcp
+ */
+function getCacheDir() {
+  const env = process.env;
+  switch (os.platform()) {
+    case "win32":
+      return path.join(
+        env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"),
+        "dejared-mcp",
+      );
+    case "darwin":
+      return path.join(os.homedir(), "Library", "Caches", "dejared-mcp");
+    default:
+      return path.join(
+        env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache"),
+        "dejared-mcp",
+      );
+  }
+}
+
+const CACHE_DIR = getCacheDir();
 const JAR_PATH = path.join(CACHE_DIR, JAR_NAME);
 const DOWNLOAD_URL = `https://github.com/HuynhKhanh1402/dejared-mcp/releases/download/v${JAR_VERSION}/${JAR_NAME}`;
 
@@ -17,6 +48,10 @@ function log(msg) {
   process.stderr.write(`[dejared-mcp] ${msg}\n`);
 }
 
+/**
+ * Resolves the Java binary path.
+ * Honours the DEJARED_JAVA_PATH env var; falls back to `java` on PATH.
+ */
 function resolveJava() {
   const envJava = process.env.DEJARED_JAVA_PATH;
   if (envJava) {
@@ -35,6 +70,11 @@ function resolveJava() {
   }
 }
 
+/**
+ * Downloads a file over HTTPS, following up to {@link redirects} redirects.
+ * Writes to a temporary file first, then atomically renames to {@link dest}
+ * to avoid leaving a partial/corrupt file on disk.
+ */
 function download(url, dest, redirects = 5) {
   return new Promise((resolve, reject) => {
     if (redirects <= 0) return reject(new Error("Too many redirects"));
@@ -72,6 +112,7 @@ function download(url, dest, redirects = 5) {
   });
 }
 
+/** Ensures the JAR exists in cache, downloading it if missing or corrupted. */
 async function ensureJar() {
   if (fs.existsSync(JAR_PATH)) {
     const stat = fs.statSync(JAR_PATH);
@@ -92,6 +133,7 @@ async function ensureJar() {
   }
 }
 
+/** Entry point – resolves Java, ensures the JAR is cached, then spawns it. */
 async function run() {
   const javaPath = resolveJava();
   await ensureJar();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dejared-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Explore, analyze, and decompile Java JAR files via MCP",
   "bin": {
     "dejared-mcp": "bin/dejared-mcp.js"