About lumen-mcp
lumen-mcp is an MCP server in the Healthcare category: ## 🔦 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.
Install
git clone https://github.com/snipefactory/lumen-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
analyze_exceptionsAnalyzes exception throw points and call chains.
Parameters not published.
analyze_hot_methodsPinpoints code lines consuming the most CPU cycles.
Parameters not published.
analyze_jdbc_queriesIdentifies slow SQL queries and their source lines (Java 11+).
Parameters not published.
analyze_lock_contentionIdentifies thread synchronization bottlenecks.
Parameters not published.
analyze_memory_usageAnalyzes GC health and object allocation hotspots.
Parameters not published.
analyze_network_ioDetects socket latency (Essential for Java 8 triage).
Parameters not published.
Ask AI
Ask AI about lumen-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
🧠 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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.