server
One local debugging server, one binary: catches errors, dumps, emails, logs, profiles and HTTP from your app in development. Speaks Sentry, Ray, VarDumper, Monolog, SMTP, XHProf. Mock server, Xdebug in the browser, MCP for AI agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/buggregator/server with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/buggregator/server'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/buggregator--server)HTML
<a href="/listings/buggregator--server"><img src="/api/listings/buggregator--server/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 168 lines · 2 findings marked
- # Buggregator — one local server for everything your app sends while you develop
- [](https://github.com/buggregator/server/releases/latest)
- [](https://github.com/buggregator/server/actions/workflows/ci.yml)
- [](https://hub.docker.com/r/butschster/buggregator)
- <a href="https://discord.gg/vDsCD3EKUB"><img src="https://img.shields.io/badge/discord-chat-magenta.svg" alt="Discord"></a>
- [](https://x.com/buggregator)
- **One ~40 MB binary catches the errors, dumps, emails, logs, profiles and HTTP requests your app sends in development — through the SDKs and protocols you already use. No account, no cloud, no Buggregator package in your app.**
- - **Errors and traces** from your Sentry SDK — exceptions, transactions, logs, metrics
- - **Dumps** from Symfony VarDumper and Spatie Ray
- - **Emails** from a fake SMTP server, with an API to wait for a message and pull links or codes in E2E tests
- - **Logs** from Monolog
- - **Profiles** from XHProf — call graph, flame chart, top functions
- - **HTTP**: catch any request, proxy outgoing calls, or answer with a **mock server** (rules or an OpenAPI spec)
- - **Xdebug in the browser**: pause, step, read variables — with or without an IDE
- - **AI agents** read all of it over MCP
- Mail, HTTP dumps, the proxy, mocks and MCP work with any language. Sentry errors, traces and logs are tested with the official SDKs for PHP, JavaScript (browser and Node.js), Python and Go.
- ## Run it in 30 seconds
- **Binary** (Linux, macOS, Windows; x86-64 and ARM):
- ```bash
- curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 27 on GitHub
- buggregator
- ```
- Windows (PowerShell):
- ```powershell
- irm https://raw.githubusercontent.com/buggregator/server/master/scripts/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 34 on GitHub
- ```
- The script picks the file for your system, checks its checksum and installs it without `sudo`. On Linux and macOS it installs into `~/.local/bin`; if that folder is not on your `PATH`, the script says so — then run `~/.local/bin/buggregator`. On Windows it installs into `%LOCALAPPDATA%\Programs\buggregator` and prints the command to start it. By default the binary listens on all network interfaces; to keep it on your machine only, see [Listen only on this machine](https://docs.buggregator.dev/install.html).
- **Docker:**
- ```bash
- docker run --pull always \
- -p 127.0.0.1:8000:8000 \
- -p 127.0.0.1:1025:1025 \
- -p 127.0.0.1:9912:9912 \
- -p 127.0.0.1:9913:9913 \
- ghcr.io/buggregator/server:latest
- ```
- Open http://127.0.0.1:8000. The UI stays empty until your app sends something.
- Events live in memory and are gone after a restart. To keep them: `buggregator -db ./buggregator.db`.
- ## Point your app at it
- Change addresses, not code. Laravel / Symfony `.env`:
- ```env
- SENTRY_LARAVEL_DSN=http://sentry@127.0.0.1:8000/1
- MAIL_HOST=127.0.0.1
- MAIL_PORT=1025
- VAR_DUMPER_SERVER=127.0.0.1:9912
- LOG_SOCKET_URL=127.0.0.1:9913
- RAY_HOST=ray@127.0.0.1
- RAY_PORT=8000
- PROFILER_ENDPOINT=http://profiler@127.0.0.1:8000
- INSPECTOR_URL=http://inspector@127.0.0.1:8000
- INSPECTOR_API_KEY=test
- HTTP_DUMP_ENDPOINT=http://http-dump@127.0.0.1:8000
- ```
- Any other stack: send mail to SMTP `127.0.0.1:1025`, send a POST or PUT to `http://127.0.0.1:8000`, or any method to `http://http-dump@127.0.0.1:8000`, to see it as a dump, and put mock rules under `http://127.0.0.1:8000/mock/`.
- Sentry from other languages — same DSN:
- ```js
- // JavaScript, browser or Node.js
- Sentry.init({ dsn: "http://sentry@127.0.0.1:8000/1", tracesSampleRate: 1.0, enableLogs: true });
- // Browser page-load traces: also pass integrations: [Sentry.browserTracingIntegration()]
- ```
- ```python
- # Python
- sentry_sdk.init(dsn="http://sentry@127.0.0.1:8000/1", traces_sample_rate=1.0, enable_logs=True)
- ```
- ```go
- // Go
- sentry.Init(sentry.ClientOptions{Dsn: "http://sentry@127.0.0.1:8000/1", EnableTracing: true, TracesSampleRate: 1.0})
- defer sentry.Flush(2 * time.Second) // short programs: send events before exit
- ```
- More setups (Spiral, WordPress, Magento, Docker Compose, Kubernetes): [Getting started](https://docs.buggregator.dev/getting-started.html).
- | Port | What listens |
- |------|--------------|
- | `8000` | Web UI, HTTP events (Sentry, Ray, Inspector, XHProf, HTTP dumps, SMS, Xdebug traces), mock server |
- | `1025` | SMTP |
- | `9912` | VarDumper (not on Windows) |
- | `9913` | Monolog |
- | `8080` | HTTP proxy |
- ## What it catches
- | | Send from | Docs |
- |---|---|---|
- | Sentry: exceptions, traces, logs, metrics | Sentry SDK (DSN) | [Sentry](https://docs.buggregator.dev/config/sentry.html) |
- | Emails | any SMTP client | [SMTP](https://docs.buggregator.dev/config/smtp.html) |
- | Dumps | Symfony VarDumper, Spatie Ray | [VarDumper](https://docs.buggregator.dev/config/var-dumper.html), [Ray](https://docs.buggregator.dev/config/ray.html) |
- | Logs | Monolog (JSON over TCP) | [Monolog](https://docs.buggregator.dev/config/monolog.html) |
- | Profiles | XHProf | [XHProf](https://docs.buggregator.dev/config/xhprof.html) |
- | APM transactions | Inspector | [Inspector](https://docs.buggregator.dev/config/inspector.html) |
- | Any HTTP request | curl, webhooks, your app | [HTTP dumps](https://docs.buggregator.dev/config/http-dumps.html) |
- | Outgoing HTTP calls | HTTP proxy on `:8080` | [HTTP proxy](https://docs.buggregator.dev/config/http-proxy.html) |
- | SMS | requests in the format of 42 SMS providers (Twilio, Vonage, Infobip…) | [SMS](https://docs.buggregator.dev/config/sms.html) |
- | Xdebug function traces | `curl` upload of a trace file | [Xdebug traces](https://docs.buggregator.dev/config/xdebug-trace.html) |
- And around it:
- - **Mock server.** Requests to `/mock/...` get the response of the first matching rule: method + path → status, headers, body, delay. Rules from the UI, the API, `buggregator.yaml`, Go templates for dynamic bodies, or one rule per operation from an OpenAPI 3.x spec. [Docs](https://docs.buggregator.dev/config/mock-server.html)
- - **Email testing API.** `GET /api/smtp/messages/wait` holds the request until the email your test expects arrives; `/links` and `/codes` pull the confirmation link or the one-time code out of it. [Docs](https://docs.buggregator.dev/config/smtp.html)
- - **Xdebug without an IDE (off by default).** Buggregator sits between Xdebug and your IDE. With no IDE attached, a script pauses at `xdebug_break()` or a saved breakpoint, and you continue or step from the browser. [Docs](https://docs.buggregator.dev/config/xdebug.html)
- - **Projects.** One instance for several apps: each event goes to the project named in its DSN, header or SMTP username. [Docs](https://docs.buggregator.dev/config/projects.html)
- - **Webhooks, SSO, Prometheus metrics** for shared or CI setups. [Webhooks](https://docs.buggregator.dev/config/webhooks.html) · [SSO](https://docs.buggregator.dev/config/sso.html) · [Metrics](https://docs.buggregator.dev/config/metrics.html)
- ## For AI agents (MCP)
- Buggregator has a built-in MCP server. Claude Code, Cursor or any MCP client can list events, read a Sentry error with its stack trace, read dumps and profiles, find the slow calls in an Xdebug trace, and create mock rules. With the Xdebug proxy on, the agent can also set breakpoints and step through PHP code.
- ```bash
- MCP_ENABLED=true buggregator
- claude mcp add buggregator -- buggregator mcp
- ```
- 23 tools by default; 35 with the Xdebug proxy, 36 with `allow_eval`. On Windows or in Docker, use the HTTP transport. Setup for other clients: [MCP](https://docs.buggregator.dev/config/mcp.html). Want an agent to install and set it up for you? Give it [this page](https://docs.buggregator.dev/agent-setup.html).
- ## Configuration
- Zero config to start. Every setting is a flag, an environment variable or a line in `buggregator.yaml` (flags win over variables, variables over the file). Annotated example: [`buggregator.yaml.example`](buggregator.yaml.example). All options: [Server configuration](https://docs.buggregator.dev/config/server.html).
- ## Build from source
- Needs Go 1.26+, PHP 8.1+ with Composer (for the VarDumper parser) and Make.
- ```bash
- make build # downloads the UI, builds the PHP parser, compiles the binary
- make run
- make build-cross GOOS=darwin GOARCH=arm64
- ```
- ## Like it?
- **If Buggregator replaced a tool or two on your machine, [give it a star](https://github.com/buggregator/server/stargazers) — that is how other developers find it.**
- - Website: [buggregator.dev](https://buggregator.dev)
- - Docs: [docs.buggregator.dev](https://docs.buggregator.dev)
- - Chat: [Discord](https://discord.gg/vDsCD3EKUB)
- - Support the author: [Patreon](https://patreon.com/butschster)
- - No binary or Docker? [Buggregator Trap](https://docs.buggregator.dev/trap/what-is-trap.html) is a small PHP CLI alternative.
- - Buggregator 1.x (PHP) lives on the [1.x branch](https://github.com/buggregator/server/tree/1.x); new work happens here.
- ## Contributing
- Found a bug or have an idea? Open an issue or a pull request. How to set up the project: [Contributing](https://docs.buggregator.dev/contributing.html).
- ## License
- MIT — see [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.