🏥

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.

0 installs

Trust: 34 — Low

Healthcare

Ask AI about lumen-mcp

I know everything about lumen-mcp. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

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."