JVM MCP Server
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Allows configuration of environment variables for remote connections through a .env file.
Used to clone the project repository.
Repository hosting for the JVM MCP Server project.
JVM MCP Server
A JVM monitoring MCP server implementation based on Arthas, providing a simple and easy-to-use Python interface for monitoring and analyzing Java processes.
Features
- Automatic download and management of Arthas tools
- Support for local and remote Java process monitoring
- Java process list querying
- Real-time JVM thread information
- JVM memory usage monitoring
- Thread stack trace information
- Class loading information querying
- Support for class and method decompilation
- Method call monitoring
- Dynamic log level adjustment
- AI-driven JVM performance analysis
System Requirements
- Python 3.10+
- Java Runtime Environment (JRE) 8+
- Network connection (for downloading Arthas)
- SSH access to target server (if using remote mode)
Installation and Environment Setup
1. Install uv tool
2. Clone the project
3. Initialize project environment using uv
4. Configure environment variables (Optional, for remote connections)
Create a .env
file and add the following configurations:
Quick Start
- Start the server using uv:
- Use in Python code:
- Using MCP tools:
Using configuration file:
Without using configuration file, it will read system environment variables, if not present it will monitor local threads:
Available Tools
Important Notes
- Ensure Java is installed in the runtime environment
- Arthas tool will be automatically downloaded on first run (arthas will be downloaded to home directory, can be downloaded in advance and named as arthas-boot.jar)
- Requires access permissions to target Java process
- Remote mode requires SSH access and appropriate user permissions
- Recommended for use in development environment, production use should be carefully evaluated
Feedback
If you encounter any issues, please submit an Issue or Pull Request.
License
This server cannot be installed
A JVM monitoring and control platform server based on Arthas that provides a Python interface for monitoring and analyzing Java processes with capabilities for thread analysis, memory monitoring, and performance diagnostics.
- Features
- System Requirements
- Installation and Environment Setup
- Quick Start
- Available Tools
- Important Notes
- Feedback
- License