debug-log-analyzer-mcp CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is the Apex Log MCP Server - a Model Context Protocol (MCP) server for Apex Log Analysis. It provides AI agents with tools to analyze Salesforce Apex debug logs for performance bottlenecks and optimization opportunities.

Development Commands

# Install dependencies
pnpm install

# Build the TypeScript project
pnpm run build

# Development with watch mode
pnpm run dev

# Run the server standalone
pnpm start

Architecture

Core Components

• src/index.ts: CLI entry point (bin) — parses flags, constructs and runs the server

• src/server.ts: Main MCP server implementation (createApexLogServer, runStdioServer, parseServerConfig)

  • Implements 4 MCP tools: apexlog_list_slow_operations, apexlog_get_summary, apexlog_list_limit_risks, apexlog_execute_anonymous
  • Uses stdio transport for communication
  • Handles file validation, log parsing, analysis, and anonymous Apex execution

• src/tools/responseShaping.ts: Shared helpers for keeping responses lean — omitEmpty, toLimitRows, toNamespaceLimitRows, roundMs, roundPercent, NS_TO_MS

• src/tools/apexLogSource.ts: The one way the three analysis tools get a log — loadApexLog (reads and parses, caching the last parse by path and a fingerprint of everything a stat can see — inode, size, and modification and change time in nanoseconds, so a cp -p that keeps the modification time still misses; the file is opened once and both the stat and the read go to that handle, so nothing can put a different file at the path between the two; the slot holds the in-flight promise, so concurrent callers share one parse and a failed read is not kept; it is dropped five minutes after its last use, on an unrefed timer, because a parsed log holds four to five times the size of the file) and walkLog

• src/ApexLogParser.ts: Complex log parsing engine (33k+ tokens)

  • Exports parse() function and ApexLogParser class
  • Handles Apex debug log format parsing into structured data
  • Tracks governor limits, performance metrics, and log issues