# Debuganything

> Debuganything is an open-source MCP server for developer tools. Lets coding agents inspect a running process and cite numbered evidence for findings. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Website:** https://debuganything.dev
- **Repository:** https://github.com/shreyassaw5394/debuganything
- **MCP Registry name:** io.github.shreyassaw5394/debuganything
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Debug Anything gives an agent read-only eyes on live software without breakpoints, restarts or instrumentation. It attaches to a process, container or pod, picks local tools such as strace, py-spy, perf, lsof, tcpdump, gdb or lldb and Node's inspector, runs them within hard limits, and turns their output into structured evidence. Each reading is logged with its time, the tool and the raw output on your disk, and every finding cites evidence ids and is marked observed or inferred.

The site walks through a reproducible Node.js memory leak: RSS growing from 47.2 MB to 323.0 MB, with one array holding most of the heap. Areas covered include memory, CPU, thread stacks and lock waits, sockets and CLOSE_WAIT build-ups, file descriptors, syscalls, network resets and container OOM kills. A single why command takes a pid and a symptom such as slow, leak, hang or crash and writes a ranked report.

Safety limits are explicit. It never kills, patches or sets breakpoints, never runs sudo for you and instead prints the command, asks before packet capture or opening a Node inspector, redacts common token formats from what the agent sees, and has no cloud, telemetry or update checks. It runs as an MCP server, a CLI and a Python package, and is MIT licensed.

## Features

- **Zero-instrumentation attach:** Observes any running process, container or pod without restarts or breakpoints.
- **Numbered evidence:** Logs every reading with time, tool and raw output, and findings cite evidence ids.
- **Symptom-driven diagnosis:** A why command chooses tools for slow, leak, hang, crash or triage cases.
- **Read-only safety:** Never kills or patches, never runs sudo, and asks before packet capture.
- **Secret redaction:** Scrubs common token, key and password formats from what the agent sees.
- **Reports:** Writes a report in which every finding lists its evidence.
- **Python and CLI access:** Usable from LangChain, LlamaIndex or CrewAI agents and from the command line.

## Good for

- Find why a Node.js or Python server's memory keeps growing
- See where CPU time goes in a slow process
- Diagnose deadlocks and lock waits through thread stacks
- Find who holds a port or why connections pile up in CLOSE_WAIT
- Check container OOM kills and limits against usage

## Install

### Claude Code (Terminal)

```sh
claude mcp add debuganything -- npx -y debuganything
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "debuganything": {
      "command": "npx",
      "args": [
        "-y",
        "debuganything"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "debuganything": {
      "command": "npx",
      "args": [
        "-y",
        "debuganything"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "debuganything": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "debuganything"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "debuganything": {
      "command": "npx",
      "args": [
        "-y",
        "debuganything"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "debuganything": {
      "command": "npx",
      "args": [
        "-y",
        "debuganything"
      ]
    }
  }
}
```

## FAQ

### Does it need root?

Most tools do not. When one does, it prints the exact command for you to run, then reads the result with debuganything import.

### Does anything leave my machine?

No. The site says there is no cloud, telemetry or update check.

### Can it change or kill processes?

No. It is read-only. The one exception is on Node, where it can send SIGUSR1 to open the inspector, only after you say yes.

### Which languages are supported?

Node, Python, Go, Java and native processes, plus containers and pods.

### How do I add it to an agent?

Run npx debuganything setup, or add an npx command with arguments -y, debuganything, serve to your MCP config.

### Is Debuganything free?

Yes. Debuganything is open source, so you can use and self-host it for free.

### How do I add Debuganything to Claude Code?

Run this command in your terminal: claude mcp add debuganything -- npx -y debuganything

### What are the best alternatives to Debuganything?

The closest alternatives to Debuganything are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/debuganything
