dejared-mcp 1.0.0 → 1.1.0

package/.claude-plugin/marketplace.json

@@ -1,8 +1,8 @@
 {
   "name": "dejared-mcp-marketplace",
   "owner": {
-    "name": "HuynhKhanh1402",
-    "email": "huynhkhanh14022004@gmail.com"
+    "name": "hqkh4nh",
+    "email": "khanh@duck.com"
   },
   "metadata": {
     "description": "MCP server and Claude Code plugin for exploring, analyzing, and decompiling Java JAR files"
@@ -12,9 +12,9 @@
       "name": "dejared",
       "source": "./",
       "description": "Explore, analyze, and decompile Java JAR files with structured workflows.",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "author": {
-        "name": "HuynhKhanh1402"
+        "name": "hqkh4nh"
       },
       "license": "MIT",
       "keywords": ["java", "jar", "decompiler", "bytecode", "reverse-engineering", "mcp"],

package/.claude-plugin/plugin.json

@@ -1,11 +1,11 @@
 {
   "name": "dejared",
   "description": "Explore, analyze, and decompile Java JAR files with structured workflows.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "author": {
-    "name": "HuynhKhanh1402"
+    "name": "hqkh4nh"
   },
-  "repository": "https://github.com/HuynhKhanh1402/dejared-mcp",
+  "repository": "https://github.com/hqkh4nh/dejared-mcp",
   "license": "MIT",
   "keywords": ["java", "jar", "decompiler", "bytecode", "reverse-engineering", "mcp"],
   "mcpServers": {

package/README.md

@@ -1,7 +1,8 @@
-[![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-17%2B-ED8B00?style=flat-square&logo=openjdk&logoColor=white)]()
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-339933?style=flat-square&logo=node.js&logoColor=white)]()
+[![npm version](https://img.shields.io/npm/v/dejared-mcp?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/dejared-mcp)
+[![npm downloads](https://img.shields.io/npm/dt/dejared-mcp?style=flat-square&color=cb3837&label=downloads)](https://www.npmjs.com/package/dejared-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
 
 # dejared-mcp
 
@@ -10,6 +11,9 @@ Designed for AI-powered development tools, dejared-mcp connects your IDE or CLI
 to inspect package structures, search bytecode, and decompile classes
 using CFR, Vineflower, or Procyon.
 
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=dejared&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dejared-mcp%22%5D%7D)
+[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=dejared&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRlamFyZWQtbWNwIl19)
+
 ## Table of Contents
 
 - [Overview](#overview)
@@ -34,13 +38,16 @@ and deep analysis. AI assistants use these tools to navigate JAR file
 structures, search for classes and string literals in bytecode, and
 decompile `.class` files back to readable Java source code.
 
+Any ZIP-based Java archive works: `.jar`, `.war`, `.ear`, `.aar`, and
+Spring Boot fat-jars.
+
 The npm package acts as a thin wrapper that downloads and caches the
 server JAR on first run, then spawns it via `java -jar` using stdio
 transport.
 
 ## Prerequisites
 
-- **Node.js** 18 or later
+- **Node.js** 20 or later
 - **Java** 17 or later (JRE is sufficient)
 
 ## Quick Start
@@ -106,8 +113,7 @@ specified per request via the `dejared_decompile_class` tool.
 
 ## Installation and Configuration
 
-The standard configuration below works with most MCP-compatible tools.
-Expand the relevant section for tool-specific instructions.
+Most clients accept this standard config:
 
 ```json
 {
@@ -120,183 +126,82 @@ Expand the relevant section for tool-specific instructions.
 }
 ```
 
-<details>
-<summary><strong>Amp</strong></summary>
-
-Add via the Amp VS Code extension settings screen or by updating your `settings.json` file:
-
-```json
-"amp.mcpServers": {
-  "dejared": {
-    "command": "npx",
-    "args": ["-y", "dejared-mcp"]
-  }
-}
-```
-
-**Amp CLI:**
+If your tool has a CLI, one line is enough:
 
 ```bash
-amp mcp add dejared -- npx -y dejared-mcp
+claude mcp add dejared -- npx -y dejared-mcp     # Claude Code
+codex mcp add dejared -- npx -y dejared-mcp      # Codex
+amp mcp add dejared -- npx -y dejared-mcp        # Amp
+gemini mcp add dejared npx -y dejared-mcp        # Gemini CLI
 ```
 
-</details>
+### Where the config file lives
 
-<details>
-<summary><strong>Antigravity Editor</strong></summary>
+Drop the standard config into the file for your tool:
 
-Edit `~/.gemini/antigravity/mcp_config.json`:
+| Tool | Location |
+|------|----------|
+| Claude Desktop | `%APPDATA%\Claude\claude_desktop_config.json` (Windows) · `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
+| Claude Code | `.mcp.json` in the project root |
+| Cursor | `.cursor/mcp.json` (project) · `~/.cursor/mcp.json` (global) |
+| Windsurf | MCP servers panel in settings, or `mcpServers` in your settings file |
+| Cline | MCP settings file, via the extension's MCP Servers panel |
+| Antigravity Editor | `~/.gemini/antigravity/mcp_config.json` |
+| Kiro | `.kiro/settings/mcp.json` |
+| Copilot CLI | `~/.copilot/mcp-config.json`, or run `/mcp add` |
+| Gemini CLI | `~/.gemini/settings.json` (global) · `.gemini/settings.json` (project) |
+| Goose | Advanced settings → Extensions → Add custom extension, type `STDIO` |
+| JetBrains IDEs | Settings → Tools → AI Assistant → Model Context Protocol (MCP) |
+| Qodo Gen | Chat panel → Connect more tools → + Add new MCP |
 
-```json
-{
-  "mcpServers": {
-    "dejared": {
-      "command": "npx",
-      "args": ["-y", "dejared-mcp"]
-    }
-  }
-}
-```
-
-Or install through the MCP Store if available.
-
-</details>
+A few setups need more than the standard config — expand those below.
 
 <details>
-<summary><strong>Claude Code</strong></summary>
-
-```bash
-claude mcp add dejared -- npx -y dejared-mcp
-```
-
-Or add it to your project's `.mcp.json` using the standard config above.
-
-**Plugin (Marketplace)** installs both the MCP server and the `/jar-analysis` skill:
+<summary><strong>Codex</strong> — TOML instead of JSON</summary>
 
 ```bash
-claude plugin marketplace add HuynhKhanh1402/dejared-mcp
-claude plugin install dejared@dejared-mcp-marketplace
+codex mcp add dejared -- npx -y dejared-mcp
+codex mcp list
 ```
 
-</details>
-
-<details>
-<summary><strong>Claude Desktop</strong></summary>
-
-Edit the Claude Desktop config file:
+The `--` matters: everything after it is the server's launch command.
 
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-
-Add the standard config above and restart Claude Desktop.
-
-</details>
-
-<details>
-<summary><strong>Cline</strong></summary>
-
-Add the standard config above to your MCP settings file.
-
-</details>
-
-<details>
-<summary><strong>Codex</strong></summary>
-
-```bash
-codex mcp add dejared npx "-y dejared-mcp"
-```
-
-Or edit `~/.codex/config.toml`:
+Or edit `~/.codex/config.toml` (global) or `.codex/config.toml` (project):
 
 ```toml
 [mcp_servers.dejared]
 command = "npx"
 args = ["-y", "dejared-mcp"]
+
+# Only if Java is not on your PATH
+[mcp_servers.dejared.env]
+DEJARED_JAVA_PATH = "/path/to/java"
 ```
 
 </details>
 
 <details>
-<summary><strong>Copilot CLI</strong></summary>
-
-Interactive:
+<summary><strong>VS Code (GitHub Copilot)</strong> — uses <code>servers</code>, not <code>mcpServers</code></summary>
 
-```
-/mcp add
-```
-
-Then fill in:
-- **Server Name**: `dejared`
-- **Server Type**: `STDIO`
-- **Command**: `npx -y dejared-mcp`
-
-Or edit `~/.copilot/mcp-config.json`:
+Create or edit `.vscode/mcp.json`:
 
 ```json
 {
-  "mcpServers": {
+  "servers": {
     "dejared": {
-      "type": "local",
       "command": "npx",
-      "args": ["-y", "dejared-mcp"],
-      "tools": ["*"]
+      "args": ["-y", "dejared-mcp"]
     }
   }
 }
 ```
 
-</details>
-
-<details>
-<summary><strong>Cursor</strong></summary>
-
-Create or edit `.cursor/mcp.json` in your project root (project-level) or `~/.cursor/mcp.json` (global) using the standard config above.
-
-</details>
-
-<details>
-<summary><strong>Gemini CLI</strong></summary>
-
-```bash
-gemini mcp add dejared npx -y dejared-mcp
-```
-
-Or edit `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project) using the standard config above.
-
-Use `/mcp` in a Gemini CLI session to verify the server is connected.
-
-</details>
-
-<details>
-<summary><strong>Goose</strong></summary>
-
-Go to **Advanced settings** > **Extensions** > **Add custom extension**. Name to your liking, use type `STDIO`, and set the command to `npx -y dejared-mcp`.
-
-</details>
-
-<details>
-<summary><strong>JetBrains IDEs</strong></summary>
-
-Go to **Settings** > **Tools** > **AI Assistant** > **Model Context Protocol (MCP)**.
-
-Click **+ Add** and configure:
-
-- **Name**: `dejared`
-- **Transport**: `Stdio`
-- **Command**: `npx`
-- **Arguments**: `-y dejared-mcp`
+After saving, click **Start** above the server entry, then use Agent mode in Copilot Chat.
 
 </details>
 
 <details>
-<summary><strong>Kiro</strong></summary>
-
-Create or edit `.kiro/settings/mcp.json` using the standard config above.
-
-</details>
-
-<details>
-<summary><strong>opencode</strong></summary>
+<summary><strong>opencode</strong> — command is an array</summary>
 
 Edit `~/.config/opencode/opencode.json`:
 
@@ -316,37 +221,13 @@ Edit `~/.config/opencode/opencode.json`:
 </details>
 
 <details>
-<summary><strong>Qodo Gen</strong></summary>
-
-Open [Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen) chat panel in VS Code or IntelliJ > Connect more tools > + Add new MCP > Paste the standard config above > Save.
-
-</details>
-
-<details>
-<summary><strong>VS Code (GitHub Copilot)</strong></summary>
-
-Create or edit `.vscode/mcp.json` in your project root:
+<summary><strong>Claude Code plugin</strong> — also installs the <code>/jar-analysis</code> skill</summary>
 
-```json
-{
-  "servers": {
-    "dejared": {
-      "command": "npx",
-      "args": ["-y", "dejared-mcp"]
-    }
-  }
-}
+```bash
+claude plugin marketplace add hqkh4nh/dejared-mcp
+claude plugin install dejared@dejared-mcp-marketplace
 ```
 
-After saving, click the **Start** button that appears in the MCP config file, then use Agent mode in Copilot Chat.
-
-</details>
-
-<details>
-<summary><strong>Windsurf</strong></summary>
-
-Open Windsurf settings, navigate to MCP servers, and add a new server using the `command` type with `npx -y dejared-mcp`. Or add the standard config under `mcpServers` in your settings.
-
 </details>
 
 <details>
@@ -354,11 +235,11 @@ Open Windsurf settings, navigate to MCP servers, and add a new server using the
 
 If you prefer to run the server JAR directly without Node.js:
 
-1. Download the latest JAR from [GitHub Releases](https://github.com/HuynhKhanh1402/dejared-mcp/releases).
+1. Download the latest JAR from [GitHub Releases](https://github.com/hqkh4nh/dejared-mcp/releases).
 
 2. Run it:
    ```bash
-   java -jar dejared-mcp-0.2.0.jar
+   java -jar dejared-mcp-<version>.jar
    ```
 
 3. Configure your MCP client to use the JAR directly instead of `npx`:
@@ -368,7 +249,7 @@ If you prefer to run the server JAR directly without Node.js:
      "mcpServers": {
        "dejared": {
          "command": "java",
-         "args": ["-jar", "/path/to/dejared-mcp-0.2.0.jar"]
+         "args": ["-jar", "/path/to/dejared-mcp-<version>.jar"]
        }
      }
    }
@@ -477,7 +358,7 @@ cd java-mcp
 
 ### Reporting Issues
 
-Open an issue on [GitHub Issues](https://github.com/HuynhKhanh1402/dejared-mcp/issues)
+Open an issue on [GitHub Issues](https://github.com/hqkh4nh/dejared-mcp/issues)
 with steps to reproduce the problem, your Java version, and your
 Node.js version.
 

package/lib/jar-runner.js

@@ -42,7 +42,7 @@ function getCacheDir() {
 
 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}`;
+const DOWNLOAD_URL = `https://github.com/hqkh4nh/dejared-mcp/releases/download/v${JAR_VERSION}/${JAR_NAME}`;
 
 function log(msg) {
   process.stderr.write(`[dejared-mcp] ${msg}\n`);
@@ -65,7 +65,7 @@ function resolveJava() {
     execFileSync("java", ["-version"], { stdio: "ignore" });
     return "java";
   } catch {
-    log("Java not found. Set DEJARED_JAVA_PATH or install Java 21+.");
+    log("Java not found. Set DEJARED_JAVA_PATH or install Java 17+.");
     process.exit(1);
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dejared-mcp",
-  "version": "1.0.0",
-  "mcpName": "io.github.HuynhKhanh1402/dejared",
+  "version": "1.1.0",
+  "mcpName": "io.github.hqkh4nh/dejared",
   "description": "Explore, analyze, and decompile Java JAR files via MCP",
   "bin": {
     "dejared-mcp": "bin/dejared-mcp.js"
@@ -16,10 +16,10 @@
     "LICENSE"
   ],
   "license": "MIT",
-  "author": "HuynhKhanh1402",
+  "author": "hqkh4nh",
   "repository": {
     "type": "git",
-    "url": "https://github.com/HuynhKhanh1402/dejared-mcp"
+    "url": "https://github.com/hqkh4nh/dejared-mcp"
   },
   "keywords": [
     "mcp",
@@ -30,6 +30,6 @@
     "reverse-engineering"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   }
 }

package/skills/jar-analysis/SKILL.md

@@ -1,13 +1,40 @@
 ---
 name: jar-analysis
 description: >
-  Explore, search, and decompile Java JAR files. Quick use cases for
-  common tasks (lookup, read config, get signatures) and workflows for
-  deeper analysis (Explore, Hunt, Deep Analysis).
+  Explore, search, read, and decompile Java JAR, WAR, EAR, AAR, and
+  Spring Boot fat-jar files via the dejared MCP server. Use this skill
+  whenever the user references a `.jar` file path, asks what a
+  third-party Java library does, wants to read a config embedded in a
+  JAR (application.yml, spring.factories, MANIFEST.MF), needs class
+  metadata (superclass, annotations, method signatures), is chasing a
+  stack trace into a dependency without source, or is reverse-engineering
+  a plugin/mod/obfuscated artifact. Applies to artifacts in
+  `~/.m2/repository`, `~/.gradle/caches`, `build/libs/`, `target/`,
+  `lib/`, and `libs/`. Prefer the dejared MCP tools over `jar tf`,
+  `jar xf`, `unzip`, `javap -p`, `javap -c`, `javap -v`, or running a
+  decompiler manually — even if the user doesn't explicitly ask for
+  "the dejared tools" or "decompilation".
 ---
 
 # JAR Analysis
 
+## When This Skill Applies
+
+Reach for these tools — never the shell — whenever the task touches the **inside** of a Java artifact:
+
+| You would reach for...                       | Use this instead                                       |
+|----------------------------------------------|--------------------------------------------------------|
+| `jar tf some.jar`                            | `dejared_list_packages` / `dejared_list_classes`       |
+| `jar tf some.jar \| grep -v .class`          | `dejared_list_resources`                               |
+| `unzip -p some.jar application.yml`          | `dejared_read_resource`                                |
+| `jar tf some.jar \| grep -i FooBar`          | `dejared_search_class`                                 |
+| `strings some.jar \| grep http`              | `dejared_search_string`                                |
+| `javap -p com.foo.Bar`                       | `dejared_get_metadata`                                 |
+| `javap -p` across a package                  | `dejared_dump_package_metadata`                        |
+| Running CFR / Vineflower / Procyon manually  | `dejared_decompile_class`                              |
+
+Applies to `.jar`, `.war`, `.ear`, `.aar` and any artifact under `~/.m2/repository`, `~/.gradle/caches`, `build/libs/`, `target/`, `lib/`, or `libs/`. All calls need an **absolute path** to the archive.
+
 ## Available Tools
 
 | Tool | Cost | Purpose |
@@ -25,6 +52,7 @@ description: >
 ## Shared Rules
 
 - All tool calls require the **absolute path** to the JAR file.
+- Prefer these MCP tools over shelling out to jar/javap/unzip/strings or asking the user to decompile manually — structured output is faster and safer for the agent to consume.
 - 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.