dejared-mcp 0.1.1 → 0.1.3

package/README.md

@@ -2,9 +2,37 @@
 
 An MCP (Model Context Protocol) server that lets AI assistants explore, analyze, and decompile Java JAR files.
 
+## Prerequisites
+
+- **Node.js 18+** - required for the `npx` wrapper (not needed for pure Java usage)
+- **Java 21+** - JRE is sufficient
+
 ## Quick Start
 
-Add to your MCP client configuration:
+Most MCP-compatible tools use a JSON configuration like this:
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"]
+    }
+  }
+}
+```
+
+See below for tool-specific instructions.
+
+## Configuration by Tool
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Edit the Claude Desktop config file:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
@@ -17,11 +45,202 @@ Add to your MCP client configuration:
 }
 ```
 
-That's it. The wrapper automatically downloads the server JAR on first run.
+Restart Claude Desktop after saving.
+
+</details>
+
+<details>
+<summary><strong>Claude Code (CLI)</strong></summary>
 
-### Custom Java Path
+Run this command in your terminal:
+
+```bash
+claude mcp add dejared -- npx -y dejared-mcp
+```
 
-If Java is not in your system PATH, set the `DEJARED_JAVA_PATH` environment variable:
+Or add it to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "command": "npx",
+      "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):
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>VS Code (GitHub Copilot)</strong></summary>
+
+Create or edit `.vscode/mcp.json` in your project root:
+
+```json
+{
+  "servers": {
+    "dejared": {
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"]
+    }
+  }
+}
+```
+
+Or add to your VS Code `settings.json` for global availability.
+
+After saving, click the **Start** button that appears in the MCP config file, then use Agent mode in Copilot Chat.
+
+</details>
+
+<details>
+<summary><strong>JetBrains IDEs (GitHub Copilot)</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`
+
+</details>
+
+<details>
+<summary><strong>Gemini CLI</strong></summary>
+
+**Option A** - CLI command:
+
+```bash
+gemini mcp add dejared npx -y dejared-mcp
+```
+
+**Option B** - Edit `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"]
+    }
+  }
+}
+```
+
+Use `/mcp` in a Gemini CLI session to verify the server is connected.
+
+</details>
+
+<details>
+<summary><strong>Antigravity Editor</strong></summary>
+
+Edit `~/.gemini/antigravity/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"]
+    }
+  }
+}
+```
+
+Or install through the MCP Store if available.
+
+</details>
+
+<details>
+<summary><strong>GitHub Copilot CLI</strong></summary>
+
+**Option A** - Interactive:
+
+```
+/mcp add
+```
+
+Then fill in:
+- **Server Name**: `dejared`
+- **Server Type**: `STDIO`
+- **Command**: `npx -y dejared-mcp`
+
+**Option B** - Edit `~/.copilot/mcp-config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dejared": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "dejared-mcp"],
+      "tools": ["*"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Pure Java (no Node.js required)</strong></summary>
+
+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).
+
+   Direct link pattern:
+   ```
+   https://github.com/HuynhKhanh1402/dejared-mcp/releases/download/v{VERSION}/dejared-mcp-{VERSION}.jar
+   ```
+
+2. Run it:
+   ```bash
+   java -jar dejared-mcp-0.1.1.jar
+   ```
+
+3. Configure your MCP client to use the JAR directly instead of `npx`. For example, in Claude Desktop:
+
+   ```json
+   {
+     "mcpServers": {
+       "dejared": {
+         "command": "java",
+         "args": ["-jar", "/path/to/dejared-mcp-0.1.1.jar"]
+       }
+     }
+   }
+   ```
+
+   Replace `/path/to/dejared-mcp-0.1.1.jar` with the actual path where you saved the JAR. This works with any MCP client that supports stdio transport.
+
+</details>
+
+## Custom Java Path
+
+If Java is not in your system PATH, set the `DEJARED_JAVA_PATH` environment variable in your MCP config. This applies to all `npx`-based configurations:
 
 ```json
 {
@@ -37,11 +256,6 @@ If Java is not in your system PATH, set the `DEJARED_JAVA_PATH` environment vari
 }
 ```
 
-## Requirements
-
-- Node.js 18+
-- Java 21+ (JRE is sufficient)
-
 ## Features
 
 **Discovery** - Browse JAR structure:
@@ -79,7 +293,7 @@ The npm package is a thin Node.js wrapper. On first run it:
 
 The server communicates over stdio.
 
-## Configuration
+## Server Configuration
 
 | Property | Default | Description |
 |----------|---------|-------------|

package/package.json

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