JMX MCP Server

A powerfulModel Context Protocol (MCP) serverthat 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

git clone https://github.com/itz4blitz/JMX-MCP.git cd JMX-MCP mvn clean package

# Test with comprehensive validation python3 comprehensive-test.py

{ "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" } } } }

Restart Claude Desktop and try these queries:

"What JMX tools are available?" "Show me the current heap memory usage" "List all MBean domains" "What's the garbage collection performance?"

The server automatically exposesall JMX attributesas MCP resources, making them discoverable and accessible to AI assistants:

- Memory Metrics: Heap usage, non-heap usage, memory pools
- Garbage Collection: GC statistics, collection times, collection counts
- Threading: Thread counts, deadlock detection, thread states
- Runtime Information: JVM uptime, start time, system properties
- Class Loading: Loaded classes, unloaded classes, class path
- Operating System: CPU usage, system load, available processors

jmx://domain:type=Type,name=Name/attributes/AttributeName

jmx://java.lang:type=Memory/attributes/HeapMemoryUsage jmx://java.lang:type=Runtime/attributes/Uptime jmx://java.lang:type=GarbageCollector,name=G1_Young_Generation/attributes/CollectionCount

User: "What's the current memory situation?" Claude: I'll check the JMX memory metrics for you. [Uses getAttribute tool to read HeapMemoryUsage] The current heap memory usage is: - Used: 245 MB - Committed: 512 MB - Max: 2048 MB - Usage: 12% of maximum heap The application is running efficiently with low memory pressure.

User: "Are there any performance issues?" Claude: Let me analyze the JMX performance metrics. [Uses multiple tools to check GC, threads, and memory] Performance analysis: ✅ Memory: Healthy (12% heap usage) ✅ GC: Efficient (avg 15ms collection time) ⚠️ Threads: High count (245 threads) - consider investigation ✅ CPU: Normal load Recommendation: Monitor thread creation patterns.

┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Claude AI │◄──►│ JMX MCP Server │◄──►│ Java App JMX │ │ │ │ │ │ │ │ Natural Language│ │ • Tools (12) │ │ • MBeans │ │ Queries │ │ • Resources(224+)│ │ • Attributes │ │ │ │ • JSON-RPC 2.0 │ │ • Operations │ │ │ │ • Multi-Connect │ │ • Discovery │ └─────────────────┘ └──────────────────┘ └─────────────────┘

- JMXConnectionManager: Manages local and remote JMX connections
- MBeanDiscoveryService: Discovers and catalogs available MBeans
- JmxService: Provides @Tool-annotated methods for AI interaction
- JMXToMCPMapper: Maps JMX attributes to MCP resources
- JmxSecurityValidator: Validates operations for security compliance

Standard configuration with full logging for development and debugging.

Optimized for Claude Desktop integration:

- Silent Operation: No console output to avoid JSON-RPC interference
- Minimal Logging: Error-only logging to prevent file system issues
- Fast Startup: Optimized initialization for quick AI responses

# Run the comprehensive integration test python3 comprehensive-test.py

- ✅ MCP Protocol compliance
- ✅ JSON-RPC 2.0 communication
- ✅ All 12 tools registration and execution
- ✅ Multi-connection management
- ✅ Service discovery and auto-registration
- ✅ Resource discovery and access
- ✅ Error handling and recovery

- ObjectName Validation: Prevents access to sensitive MBeans
- Operation Filtering: Restricts dangerous operations
- Type Safety: Validates attribute types before operations
- Access Control: Configurable security policies

jmx: security: enabled: true allowed-domains: - "java.lang" - "java.nio" - "com.myapp" blocked-operations: - "shutdown" - "restart"

java -jar target/jmx-mcp-server-1.0.0.jar

java -Xmx1g -Xms512m \ -Dspring.profiles.active=production \ -jar jmx-mcp-server-1.0.0.jar

FROM openjdk:17-jre-slim COPY target/jmx-mcp-server-1.0.0.jar app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "/app.jar"]

We welcome contributions! Please see ourContributing Guidefor details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Ensure all tests pass
- Submit a pull request

- API Documentation: Detailed API reference
- Configuration Guide: Advanced configuration options
- Troubleshooting: Common issues and solutions
- Examples: Usage examples and tutorials

We welcome contributions! Please see ourContributing Guidefor details.

# Fork the repository on GitHub git clone https://github.com/YOUR_USERNAME/JMX-MCP.git cd JMX-MCP # Build and test mvn clean compile mvn test # Run the application mvn spring-boot:run

This project is licensed under the MIT License - see theLICENSEfile for details.

- Issues:GitHub Issues
- Discussions:GitHub Discussions
- Documentation:Wiki

MCP access to cluster-wide L4 and L7 network traffic, packets, APIs, and complete payloads.