unofficial-logpare-mcp

MCP (Model Context Protocol) server for logpare, enabling AI agents to compress and analyze logs.

Unofficial package notice

This package exists because the official logpare MCP package did not appear to be available on npm at the time of publishing.

All source code in this package comes from the official repository here: https://github.com/logpare/logpare/tree/main/packages/mcp

If you are a logpare owner and would like this package taken down, please contact me at [email protected].

Installation

npm install -g unofficial-logpare-mcp
# or
pnpm add -g unofficial-logpare-mcp

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
	"mcpServers": {
		"logpare": {
			"command": "npx",
			"args": ["unofficial-logpare-mcp"]
		}
	}
}

With UCP Extension

Enable UCP tools for Universal Commerce Protocol log processing:

{
	"mcpServers": {
		"logpare": {
			"command": "npx",
			"args": ["unofficial-logpare-mcp", "--ucp"]
		}
	}
}

Available Tools

Core Tools

| Tool | Description | | ---------------------- | ------------------------------------------ | | compress_logs | Compress log lines array with full options | | compress_text | Compress multi-line log text | | analyze_patterns | Quick pattern extraction (faster) | | estimate_compression | Estimate compression ratio from sample |

UCP Tools (--ucp flag)

| Tool | Description | | ------------------------- | ---------------------------------- | | compress_checkout_logs | Compress UCP checkout session logs | | analyze_checkout_errors | Analyze UCP error patterns | | compress_a2a_logs | Compress Agent-to-Agent logs |

CLI Options

npx unofficial-logpare-mcp [options]

Options:
  --ucp, -u           Enable UCP extension
  --format, -f        Default format (summary|detailed|json)
  --depth, -d         Parse tree depth (2-8, default: 4)
  --threshold, -t     Similarity threshold (0.0-1.0, default: 0.4)
  --max-lines, -m     Max lines per request (default: 100000)
  --test              Run self-test
  --help, -h          Show help

Resources

The server exposes configuration profiles as MCP resources:

| URI | Description | | ------------------------------- | ---------------------------- | | logpare://config/default | Current default settings | | logpare://profiles/standard | Balanced compression | | logpare://profiles/aggressive | Maximum compression | | logpare://profiles/detailed | Maximum pattern preservation |

UCP Resources (--ucp flag)

| URI | Description | | --------------------------------- | ------------------------- | | logpare://ucp/profiles/checkout | UCP checkout log settings | | logpare://ucp/profiles/a2a | UCP A2A log settings | | logpare://ucp/error-codes | UCP error code reference |

Programmatic Usage

import { createServer, startStdioServer } from 'unofficial-logpare-mcp';

// Create server with custom config
const server = createServer({
	defaultFormat: 'detailed',
	defaultDepth: 5,
	ucp: { enabled: true }
});

// Or start with stdio transport
await startStdioServer({
	ucp: { enabled: true }
});

UCP Compatibility

This package is UCP-Ready, supporting the Universal Commerce Protocol for agentic commerce. When UCP mode is enabled:

• Recognizes UCP checkout session IDs (cs_*)
• Extracts UCP error codes and status transitions
• Provides UCP-specific compression profiles
• Outputs UCP-enhanced JSON format (ucp_json)

Learn more at ucp.dev.

License

MIT.

This package is derived from the logpare MCP package and preserves the upstream MIT copyright and permission notice in the root LICENSE file.