MemoryLens.Mcp 1.3.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
{
  "servers": {
    "MemoryLens.Mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["MemoryLens.Mcp@1.3.0", "--yes"]
    }
  }
}
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file. 
dotnet tool install --global MemoryLens.Mcp --version 1.3.0
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local MemoryLens.Mcp --version 1.3.0
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=MemoryLens.Mcp&version=1.3.0
                    


                    

                
nuke :add-package MemoryLens.Mcp --version 1.3.0

<p align="center"> <img src="icon.svg" width="128" height="128" alt="MemoryLens MCP"> </p>

<h1 align="center">MemoryLens MCP</h1>

<p align="center"> <a href="https://www.nuget.org/packages/MemoryLens.Mcp"><img src="https://img.shields.io/nuget/v/MemoryLens.Mcp?style=flat-square&logo=nuget&color=blue" alt="NuGet"></a> <a href="https://www.nuget.org/packages/MemoryLens.Mcp"><img src="https://img.shields.io/nuget/dt/MemoryLens.Mcp?style=flat-square&color=green" alt="NuGet Downloads"></a> <a href="https://github.com/MarcelRoozekrans/memorylens-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/MarcelRoozekrans/memorylens-mcp/ci.yml?branch=main&style=flat-square&logo=github" alt="Build Status"></a> <a href="https://github.com/MarcelRoozekrans/memorylens-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/MarcelRoozekrans/memorylens-mcp?style=flat-square" alt="License"></a> </p>

<p align="center"> On-demand .NET memory profiling with concrete, AI-actionable code fix suggestions — wraps JetBrains dotMemory with a heuristic-based rule engine. </p>

Quick Start

VS Code / Visual Studio (via dnx)

Add to your MCP settings (.vscode/mcp.json or VS settings):

{
  "servers": {
    "memorylens": {
      "type": "stdio",
      "command": "dnx",
      "args": ["MemoryLens.Mcp", "--yes"]
    }
  }
}

Claude Code Plugin

claude install gh:MarcelRoozekrans/memorylens-mcp

.NET Global Tool

dotnet tool install -g MemoryLens.Mcp

Prerequisites

Available MCP Tools

Tool Description
ensure_dotmemory Downloads and verifies the JetBrains dotMemory CLI tool is available
list_processes Lists running .NET processes available for profiling
snapshot Captures a single memory snapshot of a target process
compare_snapshots Captures two snapshots with configurable delay and compares them
analyze Runs the rule engine against a captured snapshot and returns findings
get_rules Lists all available analysis rules with their metadata

Built-in Rules

ID Severity Category Description
ML001 critical leak Event handler leak detected
ML002 critical leak Static collection growing unbounded
ML003 high leak Disposable object not disposed
ML004 high fragmentation Large Object Heap fragmentation
ML005 medium retention Object retained longer than expected
ML006 medium allocation Excessive allocations in hot path
ML007 medium retention Closure retaining unexpected references
ML008 low allocation Array/list resizing without capacity hint
ML009 low pattern Finalizer without Dispose pattern
ML010 low pattern String interning opportunity

Configuration

Create a .memorylens.json file in your project root to customize rule behavior:

{
  "rules": {
    "ML001": { "enabled": true, "severity": "critical" },
    "ML002": { "enabled": true, "severity": "critical" },
    "ML003": { "enabled": true, "severity": "high" },
    "ML004": { "enabled": true, "severity": "high" },
    "ML005": { "enabled": true, "severity": "medium" },
    "ML006": { "enabled": true, "severity": "medium" },
    "ML007": { "enabled": true, "severity": "medium" },
    "ML008": { "enabled": true, "severity": "low" },
    "ML009": { "enabled": true, "severity": "low" },
    "ML010": { "enabled": true, "severity": "low" }
  }
}

Usage Examples

Single Snapshot

Capture a memory snapshot of a running process to inspect current memory state:

> /memorylens
> Take a snapshot of my running API (PID 12345)

Claude will call ensure_dotmemory, then snapshot with the target PID, then analyze the result and present findings ordered by severity.

Before/After Comparison

Detect memory growth by comparing two snapshots taken with a delay:

> /memorylens
> Check if my app has a memory leak — compare before and after processing 1000 requests

Claude will call compare_snapshots with a configurable wait period, then analyze the diff to identify objects that grew between snapshots.

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.3.0 43 3/10/2026
1.2.0 40 3/10/2026
1.1.0 48 3/10/2026
1.0.0 44 3/9/2026