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

Related MCP server: Arthas MCP Server

🚀 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

📖 Usage Example

"Gemini, use lumen to analyze data/incident.jfr. Tell me why the database response is slow."

© 2026 SnipeFactory. All rights reserved.