广告合作
MCP.so
登录
H

Heap Seance MCP Server

@SegfaultSorcerer

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

SegfaultSorcerer

提交者

Patrik Neumann

关于 Heap Seance MCP Server

Java memory leak diagnostics via MCP. Channels jcmd, jmap, jstat, JFR, Eclipse MAT, and async-profiler into a structured investigation workflow with confidence-based verdicts. Two slash commands: /leak-scan (conservative) and /leak-deep (full forensics). Designed for Claude Code.

#java#memory-leak#jvm#heap-dump#mcp#claude-code#diagnostics#profiling#eclipse-mat#async-profiler#jfr#garbage-collection

Heap Seance MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "heap-seance": {
      "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"
      }
    }
  }
}

Heap Seance MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Heap Seance?

Heap Seance is an MCP server and CLI toolkit that integrates jcmd, jmap, jstat, jfr, Eclipse MAT, and async-profiler into a structured Java heap leak investigation workflow. It is designed to run inside Claude Code and provides two slash commands and eight MCP tools for conservative-to-deep leak analysis.

How to use Heap Seance?

Clone the repository, add a .mcp.json configuration to your Java project pointing to the Heap Seance directory, and copy the .claude/commands/ folder into the project. Then invoke the /leak-scan or /leak-deep slash commands from Claude Code, or use the CLI directly via uv run heap-seance --mode scan --match <name> or --mode deep --pid <pid>. The tools require Python 3.10+, JDK 17+, and uv. Deep mode additionally requires Eclipse MAT CLI.

Key features of Heap Seance

  • Two‑stage escalation: /leak-scan (conservative) then /leak-deep (full forensics)
  • Eight MCP tools: process listing, class histograms, GC snapshots, JFR recording, heap dumps, MAT leak suspects, and async-profiler allocation profiles
  • Unified confidence ladder: none → low → medium → high based on independent signals
  • Conservative by default: no deep forensics unless evidence demands it
  • Automatic artifact saving for team review
  • CLI mode available without Claude Code

Use cases of Heap Seance

  • Diagnosing Java memory leaks in production or staging environments
  • Identifying root holder chains and dominant retainers in heap dumps
  • Validating fix effectiveness by re‑scanning after code changes
  • Investigating growth patterns combined with GC pressure signals
  • Generating structured evidence for team reviews or incident reports

常见问题

1

What dependencies are required?

Python 3.10+, JDK 17+ for tooling (`jcmd`, `jmap`, `jstat`), and `uv` for environment management. Deep mode (`/leak-deep`) requires Eclipse MAT CLI. async‑profiler is optional.

2

Can Heap Seance analyze Java 8 target applications?

Yes, histogram, GC, and MAT work fully. JFR is skipped for Java 8 targets due to incompatible file format.

3

Where does Heap Seance save artifacts?

By default, artifacts (`.jfr`, `.hprof`, MAT reports) are saved to the system temporary directory. Override with the `HEAP_SEANCE_ARTIFACT_DIR` environment variable.

4

Is async-profiler required for deep mode?

No, async‑profiler is optional. Deep mode works without it, using JFR and MAT for evidence.

5

What Java version does the target application need?

The target application can run any Java version (including Java 8). The tooling JDK must be 17+.

评论

其他 分类下的更多 MCP 服务器

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

广告合作