Каталог MCP
SegfaultSorcerer/heap-seance

SegfaultSorcerer/heap-seance

Name: SegfaultSorcerer/heap-seance
Availability: InStock
Author: segfaultsorcerer

MCP сервер Heap Seance автоматизирует расследование утечек памяти в Java-приложениях, объединяя jcmd, jmap, jstat, JFR, Eclipse MAT и async-profiler в структурированный рабочий процесс. Помогает разработчикам и DevOps быстро выявлять и анализировать утечки памяти.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Heap Seance

Summoning retained objects from the heap — so you can interrogate what refuses to die.

An MCP server + CLI toolkit that channels the spirits of jcmd, jmap, jstat, jfr, Eclipse MAT, and async-profiler into a structured leak investigation workflow — designed to run inside Claude Code.

2 slash commands. 8 MCP tools. Conservative by default.

How It Works • Quick Start • MCP Tools • Workflow • Prerequisites • Contributing

How It Works

Heap Seance follows a two-stage escalation model. No deep forensics unless the evidence demands it.

 /leak-scan                          /leak-deep
     |                                   |
     v                                   v
  3x class histogram               (all of scan, plus)
  + GC pressure snapshot            JFR recording
     |                              heap dump
     v                              MAT leak suspects
  monotonic growth?                 async-profiler alloc profile
  old-gen pressure?                     |
     |                                  v
     +--- both true? -----> auto-escalate to deep
     |
     +--- otherwise ------> verdict + next steps

Confidence is earned, not assumed. high requires at least two independent strong signals. A single growing class is watch. Growth plus GC pressure is suspicious. Add a MAT dominator or JFR correlation and you get probable_memory_leak.

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить SegfaultSorcerer/heap-seance:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"segfaultsorcerer-heap-seance-5m0gbk89fl\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"run\",\"--directory\",\"/path/to/heap-seance\",\"python\",\"-m\",\"heap_seance_mcp.server\"],\"env\":{\"JAVA_HOME\":\"/path/to/jdk-17\",\"MAT_BIN\":\"/path/to/ParseHeapDump.sh\",\"ASYNC_PROFILER_BIN\":\"/path/to/asprof\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add segfaultsorcerer-heap-seance-5m0gbk89fl --env JAVA_HOME=/path/to/jdk-17 --env MAT_BIN=/path/to/ParseHeapDump.sh --env ASYNC_PROFILER_BIN=/path/to/asprof -- uv run --directory /path/to/heap-seance python -m heap_seance_mcp.server

Либо через JSON-конфиг:

claude mcp add-json segfaultsorcerer-heap-seance-5m0gbk89fl "{\"command\":\"uv\",\"args\":[\"run\",\"--directory\",\"/path/to/heap-seance\",\"python\",\"-m\",\"heap_seance_mcp.server\"],\"env\":{\"JAVA_HOME\":\"/path/to/jdk-17\",\"MAT_BIN\":\"/path/to/ParseHeapDump.sh\",\"ASYNC_PROFILER_BIN\":\"/path/to/asprof\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add segfaultsorcerer-heap-seance-5m0gbk89fl --env JAVA_HOME=/path/to/jdk-17 --env MAT_BIN=/path/to/ParseHeapDump.sh --env ASYNC_PROFILER_BIN=/path/to/asprof -- uv run --directory /path/to/heap-seance python -m heap_seance_mcp.server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.segfaultsorcerer-heap-seance-5m0gbk89fl]
command = "uv"
args = ["run", "--directory", "/path/to/heap-seance", "python", "-m", "heap_seance_mcp.server"]

[mcp_servers.segfaultsorcerer-heap-seance-5m0gbk89fl.env]
JAVA_HOME = "/path/to/jdk-17"
MAT_BIN = "/path/to/ParseHeapDump.sh"
ASYNC_PROFILER_BIN = "/path/to/asprof"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите SegfaultSorcerer/heap-seance, а в поле команды запуска — строку ниже:

uv run --directory /path/to/heap-seance python -m heap_seance_mcp.server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например segfaultsorcerer-heap-seance-5m0gbk89fl.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: segfaultsorcerer-heap-seance-5m0gbk89fl
    command: uv
    args:
      - "run"
      - "--directory"
      - "/path/to/heap-seance"
      - "python"
      - "-m"
      - "heap_seance_mcp.server"
    env:
      JAVA_HOME: /path/to/jdk-17
      MAT_BIN: /path/to/ParseHeapDump.sh
      ASYNC_PROFILER_BIN: /path/to/asprof

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "segfaultsorcerer-heap-seance-5m0gbk89fl": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/heap-seance",
        "python",
        "-m",
        "heap_seance_mcp.server"
      ],
      "env": {
        "JAVA_HOME": "/path/to/jdk-17",
        "MAT_BIN": "/path/to/ParseHeapDump.sh",
        "ASYNC_PROFILER_BIN": "/path/to/asprof"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/heap-seance",
    "python",
    "-m",
    "heap_seance_mcp.server"
  ],
  "env": {
    "JAVA_HOME": "/path/to/jdk-17",
    "MAT_BIN": "/path/to/ParseHeapDump.sh",
    "ASYNC_PROFILER_BIN": "/path/to/asprof"
  }
}