
A powerful Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop to monitor and manage Java applications through JMX.
概览
A powerful that provides comprehensive JMX monitoring and management capabilities for AI assistants like Claude Desktop. Monitor Java applications, manage MBeans, and perform JMX operations through natural language interactions. Watch the JMX MCP Server in action! See how Claude Desktop can monitor and manage Java applications through natural language: https://github.com/user-attachments/assets/722e1885-5aeb-4584-8116-b93324e0abc1 The demo shows real-time JMX monitoring, MBean exploration, and AI-powered Java application management through Claude Desktop. - : Automatically discovers and catalogs all available MBeans - : Read and write MBean attributes with full type safety - : Execute MBean operations with parameter validation - : Browse and filter MBeans by domain - : Ask questions like "What's the current heap memory usage?
README
以下为原文 README 节选,完整内容请查看原文。
JMX MCP Server
A powerful Model Context Protocol (MCP) server that provides comprehensive JMX monitoring and management capabilities for AI assistants like Claude Desktop. Monitor Java applications, manage MBeans, and perform JMX operations through natural language interactions.
🎥 Demo Video
Watch the JMX MCP Server in action! See how Claude Desktop can monitor and manage Java applications through natural language:
https://github.com/user-attachments/assets/722e1885-5aeb-4584-8116-b93324e0abc1
The demo shows real-time JMX monitoring, MBean exploration, and AI-powered Java application management through Claude Desktop.
🚀 Features
🔍 Comprehensive JMX Integration
- Real-time MBean Discovery: Automatically discovers and catalogs all available MBeans
- Attribute Management: Read and write MBean attributes with full type safety
- Operation Execution: Execute MBean operations with parameter validation
- Domain Exploration: Browse and filter MBeans by domain
🤖 AI-Powered Monitoring
- Natural Language Queries: Ask questions like “What’s the current heap memory usage?”
- Intelligent Analysis: AI can correlate metrics and identify performance issues
- Automated Insights: Get recommendations based on JMX data patterns
🛡️ Enterprise-Ready
- Security Validation: Built-in security controls and access validation
- Connection Management: Robust local and remote JMX connection handling
- Error Handling: Comprehensive error handling and recovery mechanisms
- Production Logging: Configurable logging for different environments
🔌 MCP Protocol Compliance
- Tools: 12 JMX management tools for AI interaction
- Resources: All JMX attributes exposed as discoverable resources
- STDIO Transport: Optimized for Claude Desktop integration
- JSON-RPC 2.0: Full protocol compliance for reliable communication
📋 Prerequisites
- Java 17+ (OpenJDK or Oracle JDK)
- Maven 3.6+ for building
- Claude Desktop or any MCP-compatible AI client
🛠️ Quick Start
1. Clone and Build
git clone https://github.com/itz4blitz/JMX-MCP.git
cd JMX-MCP
mvn clean package
2. Test the Server
# Test with comprehensive validation
python3 comprehensive-test.py
3. Configure Claude Desktop
Add to your Claude Desktop MCP configuration file:
Location:
- macOS:
~/.config/claude/mcp_servers.json - Windows:
%APPDATA%\Claude\mcp_servers.json
Configuration:
{
"mcpServers": {
"jmx-mcp-server": {
"command": "java",
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"jmx-mcp-server": {
"command": "java",
"args": [
"-Xmx512m",
"-Xms256m",
"-Dspring.profiles.active=stdio",
"-Dspring.main.banner-mode=off",
"-Dlogging.level.root=OFF",
"-Dspring.main.log-startup-info=false",
"-jar",
"/path/to/your/jmx-mcp-server-1.0.0.jar"
],
"env": {
"JAVA_OPTS": "-Djava.awt.headless=true"
}
}
}
}