npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

jdb-mcp

v1.0.0

Published

An MCP server that turns an LLM into a Java debugger via JDI - pre-declare the values you want before a breakpoint fires and get back a compact structured snapshot, no heap dumps. Requires JDK 17+.

Readme

jdb-mcp - Let your LLM debug Java (JDB / JDI over MCP, for Claude Code & any MCP client)

jdb-mcp turns an LLM into a Java debugger. It exposes JDI - the engine behind jdb and the JDWP protocol - as an MCP server, so AI agents like Claude Code can set breakpoints, step through code, capture exceptions, and inspect a live JVM. The core advantage: the AI pre-declares exactly which values it wants before the breakpoint fires, and jdb-mcp returns only those as a compact structured snapshot - no heap dumps, no stack-dredging, no context blowup.

Keywords: LLM · AI agent · Java DEBUG · JDB · JDI · JDWP · MCP · Claude Code · breakpoint · live JVM inspection

Pre-declare your data, set one breakpoint, verify, stop. Anti-addiction built in - a session counter warns after 8+ debug actions, steering the AI toward logs/tests first.

Quick Start

# Requires JDK 17+ (none of the source - just install and go)
npm install -g jdb-mcp

# Or use without installing:
npx jdb-mcp

Set JAVA_HOME if your JDK isn't on the PATH:

# Linux / macOS
export JAVA_HOME=/path/to/jdk-17

# Windows
set JAVA_HOME=F:\path\to\jdk-17

Claude Code Wiring

{
  "mcpServers": {
    "jdb-mcp": {
      "command": "npx",
      "args": ["jdb-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "jdb-mcp": {
      "command": "jdb-mcp"
    }
  }
}

If your JDK isn't on the PATH, set it inline:

{
  "mcpServers": {
    "jdb-mcp": {
      "command": "npx",
      "args": ["jdb-mcp"],
      "env": { "JAVA_HOME": "/path/to/jdk-17" }
    }
  }
}

How It Works

  1. The jdb-mcp command finds your JDK 17+ (JAVA_HOME -> PATH -> common locations).
  2. It launches the bundled JDI debug server over MCP stdio.
  3. The AI calls start_session(jar="...") to launch your target, or start_session(attach={host, port}) to attach.
  4. Set breakpoints with pre-declared captures, get snapshots, step through code, inspect exceptions.

Requirements

  • JDK 17+ (any distribution: Eclipse Adoptium, Oracle, Microsoft, etc.)
  • Node.js 16+ (just to run the wrapper script)
  • No source code, no Maven, no build step - just npm install

Tools

17 MCP tools: start_session, stop_session, configure, session_status, list_debuggable_jvms, resolve_class, list_classes, set_breakpoint, set_exception_breakpoint, list_hits, remove_breakpoint, resume, get_frames, get_variables, step, explore, eval.

See the full README for the expression grammar, modes, limits, and safety policy.

License

MIT - the most permissive open-source license. Use it commercially, fork it, ship it, no strings attached. See LICENSE.