lumen-mcp
## π¦ SnipeFactory: Lumen MCP Engine Lumen MCP is a specialized forensic analysis server designed to give AI agents (Gemini, Claude, etc.) the "eyes" to see inside a Java Virtual Machine. By parsing **JVM Flight Recorder (JFR)** binary data, Lumen enables real-time troubleshooting and post-mortem investigation of production incidents. ### π Key Capabilities - **Incident Forensics:** Automatically trace "swallowed" exceptions and hidden errors that standard logs miss. - **SQL Intelligence:** Pinpoint slow database queries and map them directly to your DAO/Mapper code (Java 11+). - **Socket Latency Analysis:** Detect bottlenecks in RDS, Redis, or external API calls through deep network I/O triage. - **Resource Profiling:** Identify CPU hotspots and memory allocation issues with line-level precision. ### πΉ The SnipeFactory Edge Unlike standard monitoring tools that only show "what" happened, Lumen shows you **"why"** and **"where"** in your code the failure occurred. It is built for developers who need to snipe performance bottlenecks with surgical precision. --- Β© 2026 **SnipeFactory**. Part of the Lumen Incident Forensic System.
Ask AI about lumen-mcp
Powered by Claude Β· Grounded in docs
I know everything about lumen-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
π§ SnipeFactory: Lumen MCP Engine
JVM Flight Recorder (JFR) Forensic Engine for LLM
Hybrid TypeScript/Java MCP Server for Advanced JVM Analysis
Lumen MCP is the analytical brain of the Lumen ecosystem. It leverages a high-performance Java engine to parse JFR files and a TypeScript bridge to provide a seamless Model Context Protocol (MCP) interface for AI agents like Gemini and Claude.
β¨ Key Features
- Hybrid Intelligence: Combines Java's deep JFR parsing power with Node.js's ecosystem compatibility.
- Exception Forensics: Trace hidden exceptions (Swallowed Exceptions) with full call chains.
- SQL & I/O Analytics: Pinpoint slow queries and socket latencies with line-level precision.
- Smithery Ready: Fully compatible with Smithery CLI for instant distribution.
π Installation & Setup
1. Build the Project
Lumen MCP requires both Node.js (18+) and Java (11+) to build.
npm install
npm run build
(This command runs tsc for the bridge and ./gradlew installDist for the engine.)
2. Register with Gemini CLI
You can now run Lumen using the Node.js bridge (Recommended):
{
"mcpServers": {
"lumen": {
"command": "node",
"args": [
"/path/to/lumen-mcp/dist/server.js"
]
}
}
}
π Diagnostic Tools
| Tool | Description |
|---|---|
analyze_exceptions | Analyzes exception throw points and call chains. |
analyze_jdbc_queries | Identifies slow SQL queries and their source lines (Java 11+). |
analyze_network_io | Detects socket latency (Essential for Java 8 triage). |
analyze_hot_methods | Pinpoints code lines consuming the most CPU cycles. |
analyze_memory_usage | Analyzes GC health and object allocation hotspots. |
analyze_lock_contention | Identifies thread synchronization bottlenecks. |
π Usage Example
"Gemini, use lumen to analyze
data/incident.jfr. Tell me why the database response is slow."
Β© 2026 SnipeFactory. All rights reserved.
