javaperf — Claude Code MCP server: setup
An MCP server for Java profiling through jcmd, jfr, and jps. Use it to inspect threads, memory, GC, and JFR recordings.
claude mcp add javaperf -- npx -y javaperfWhat javaperf does
javaperf gives an AI agent access to JDK profiling utilities and tools for inspecting live Java processes. It can start and stop JFR recordings, read CPU profiles, and summarize network, file, memory, and garbage-collection activity.
Its MCP tools cover deadlock checks, thread snapshots, heap histograms, heap dumps, JVM details, compiler queues, code cache, and native memory. JFR analysis includes method traces, allocation data, GC efficiency, CPU bottlenecks, and call frequency.
The server requires Node.js v18+ and JDK 8u262+ or 11+ with JFR support. It discovers jps, jcmd, and jfr through JAVA_HOME or which java; set JAVA_HOME explicitly when jps cannot be found.
What it helps with
- list running Java processes and their PIDs
- capture a JFR profile for a chosen duration
- inspect CPU, memory, GC, and I/O behaviour
- detect Java-level deadlocks and lock waits
- track growth across heap histograms
Example prompts for the agent
- List the running Java processes and show their PIDs.
- Capture a 60-second JFR profile for process 1234.
- Analyze
recordings/new_profile.jfrfor CPU hotspots and GC behaviour.
How to install javaperf
Platform CLI
claude mcp add javaperf -- npx -y javaperfPlatform CLI
codex mcp add javaperf -- npx -y javaperfConfig file
{
"mcpServers": {
"javaperf": {
"command": "npx",
"args": [
"-y",
"javaperf"
]
}
}
}Config file
{
"servers": {
"javaperf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"javaperf"
]
}
}
}Platform CLI
gemini mcp add javaperf npx -y javaperfStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about javaperf
How do I install javaperf in Claude Code?
Run claude mcp add javaperf -- npx -y javaperf.
What does javaperf do?
It connects an AI agent to jcmd, jfr, and jps for Java profiling, thread analysis, memory checks, GC inspection, and JFR parsing.
What does javaperf need to run?
You need Node.js v18+ and JDK 8u262+ or 11+ with JFR support. Set JAVA_HOME to the JDK root if jps, jcmd, or jfr is not detected.
