JVM Server
This is an implementation project of a JVM-based MCP (Model Context Protocol) server. The project aims to provide a standardized MCP server implementation for the JVM platform, enabling AI models to better interact with the Java ecosystem.
What is JVM Server?
JVM Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is an implementation project of a jvm-based mcp (model context protocol) server. the project aims to provide a standardized mcp server implementation for the jvm platform, enabling ai models to b...
This is an implementation project of a JVM-based MCP (Model Context Protocol) server. The project aims to provide a standardized MCP server implementation for the JVM platform, enabling AI models to better interact with the Java ecosystem.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This is an implementation project of a JVM-based MCP (Model
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx jvmConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use JVM Server
The JVM MCP Server gives AI agents a live window into running Java Virtual Machine processes, exposing 15 tools that cover thread analysis, memory inspection, class decompilation, method tracing, logger management, and JVM diagnostics. It supports both local JVM monitoring and remote monitoring via SSH, making it suitable for diagnosing production Java services or debugging JVM applications from within an AI assistant session. The server is built in Python using standard JVM diagnostic tools like jcmd and jstat.
Prerequisites
- Python 3.10 or later with pip or uv installed
- A running JVM process to monitor (Java 11 or later recommended)
- JDK tools available on PATH (jcmd, jstat, jstack) on the monitored machine
- SSH access credentials if monitoring a remote JVM (SSH_HOST, SSH_USER, SSH_KEY or SSH_PASSWORD)
- An MCP client such as Claude Desktop or Claude Code
Install jvm-mcp-server via pip or uv
Install the server package from PyPI into your Python environment.
pip install jvm-mcp-server
# or with uv:
uv pip install jvm-mcp-serverConfigure remote SSH monitoring (if needed)
For monitoring a remote JVM over SSH, create a .env file with the connection details. Skip this step for local JVM monitoring.
# .env file
SSH_HOST=192.168.1.100
SSH_PORT=22
SSH_USER=ubuntu
SSH_KEY=/home/user/.ssh/id_rsa
# Or use SSH_PASSWORD instead of SSH_KEYStart the server locally or with remote SSH config
Run the server directly for local monitoring, or pass the env file for remote monitoring.
# Local JVM monitoring
uv run jvm-mcp-server
# Remote JVM monitoring via SSH
uv run --env-file .env jvm-mcp-serverAdd the server to your MCP client configuration
Register jvm-mcp-server in your Claude Desktop config, pointing to the .env file if using remote monitoring.
{
"mcpServers": {
"jvm-mcp-server": {
"command": "uv",
"args": ["run", "--env-file", "/path/to/.env", "jvm-mcp-server"],
"env": {}
}
}
}Restart your MCP client and start diagnosing JVM processes
Restart Claude Desktop. The 15 JVM tools will be available. Ask the assistant to list running Java processes or show memory usage.
JVM Server Examples
Client configuration
Claude Desktop JSON config for local JVM monitoring using uv.
{
"mcpServers": {
"jvm-mcp-server": {
"command": "uv",
"args": ["run", "jvm-mcp-server"],
"env": {}
}
}
}Prompts to try
Example prompts that use the JVM diagnostic tools.
- "List all running Java processes on this machine."
- "Show me the thread dump for the Spring Boot application with PID 12345."
- "What is the heap memory usage of JVM process 12345 right now?"
- "Decompile the class com.example.UserService from process 12345."
- "Show the GC statistics for the running Tomcat process."
- "Set the log level for com.example to DEBUG on process 12345."Troubleshooting JVM Server
list_java_processes returns an empty list
Ensure at least one JVM process is running. Confirm jcmd is available on PATH by running 'jcmd' in a terminal. On some systems you may need to install the full JDK (not just JRE) to get jcmd.
SSH connection refused or authentication failure for remote monitoring
Verify SSH_HOST, SSH_PORT, SSH_USER, and either SSH_KEY or SSH_PASSWORD are correct in your .env file. Test the connection manually with 'ssh -i $SSH_KEY $SSH_USER@$SSH_HOST'. Ensure the remote host has jcmd and jstack on the PATH of the SSH user.
uv command not found
Install uv with 'pip install uv' or via the official installer at https://docs.astral.sh/uv/. Alternatively, use 'python -m jvm_mcp_server' if you prefer to run without uv.
Frequently Asked Questions about JVM Server
What is JVM Server?
JVM Server is a Model Context Protocol (MCP) server that this is an implementation project of a jvm-based mcp (model context protocol) server. the project aims to provide a standardized mcp server implementation for the jvm platform, enabling ai models to better interact with the java ecosystem. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install JVM Server?
Follow the installation instructions on the JVM Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with JVM Server?
JVM Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is JVM Server free to use?
Yes, JVM Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
JVM Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to JVM Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up JVM Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use JVM Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.