claudeers.
// Uncategorized / Others

server

One local debugging server, one binary: catches errors, dumps, emails, logs, profiles and HTTP from your app in development. Speaks Sentry, Ray, VarDumper, M…

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up server (git-clone project) into my current project.
Found on https://claudeers.com/server
Repo: https://github.com/buggregator/server
Homepage/docs: https://buggregator.dev
Detected install method: git-clone → git clone https://github.com/buggregator/server
Category: uncategorized. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/buggregator/server

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageGo

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Buggregator — one local server for everything your app sends while you develop

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):

curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
buggregator

Windows (PowerShell):

irm https://raw.githubusercontent.com/buggregator/server/master/scripts/install.ps1 | iex

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.

Docker:

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:

SENTRY_LARAVEL_DSN=http://[email protected]: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
[email protected]
RAY_PORT=8000
PROFILER_ENDPOINT=http://[email protected]:8000
INSPECTOR_URL=http://[email protected]:8000
INSPECTOR_API_KEY=test
HTTP_DUMP_ENDPOINT=http://[email protected]: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://[email protected]: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:

// JavaScript, browser or Node.js
Sentry.init({ dsn: "http://[email protected]:8000/1", tracesSampleRate: 1.0, enableLogs: true });
// Browser page-load traces: also pass integrations: [Sentry.browserTracingIntegration()]
# Python
sentry_sdk.init(dsn="http://[email protected]:8000/1", traces_sample_rate=1.0, enable_logs=True)
// Go
sentry.Init(sentry.ClientOptions{Dsn: "http://[email protected]: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.

PortWhat listens
8000Web UI, HTTP events (Sentry, Ray, Inspector, XHProf, HTTP dumps, SMS, Xdebug traces), mock server
1025SMTP
9912VarDumper (not on Windows)
9913Monolog
8080HTTP proxy

What it catches

Send fromDocs
Sentry: exceptions, traces, logs, metricsSentry SDK (DSN)Sentry
Emailsany SMTP clientSMTP
DumpsSymfony VarDumper, Spatie RayVarDumper, Ray
LogsMonolog (JSON over TCP)Monolog
ProfilesXHProfXHProf
APM transactionsInspectorInspector
Any HTTP requestcurl, webhooks, your appHTTP dumps
Outgoing HTTP callsHTTP proxy on :8080HTTP proxy
SMSrequests in the format of 42 SMS providers (Twilio, Vonage, Infobip…)SMS
Xdebug function tracescurl upload of a trace fileXdebug traces

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
  • 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
  • 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
  • Projects. One instance for several apps: each event goes to the project named in its DSN, header or SMTP username. Docs
  • Webhooks, SSO, Prometheus metrics for shared or CI setups. Webhooks · SSO · Metrics

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.

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. Want an agent to install and set it up for you? Give it this page.

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. All options: Server configuration.

Build from source

Needs Go 1.26+, PHP 8.1+ with Composer (for the VarDumper parser) and Make.

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 — that is how other developers find it.

Contributing

Found a bug or have an idea? Open an issue or a pull request. How to set up the project: Contributing.

License

MIT — see LICENSE.

// faq

What is 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.. It is open-source on GitHub.

Is server free to use?

server is open-source under the MIT license, so it is free to use.

What category does server belong to?

server is listed under uncategorized in the Claudeers registry of Claude-compatible tools.

7 views
★ 1,078 stars
unclaimed
updated 4 days ago

// embed badge

server on Claudeers
[![Claudeers](https://claudeers.com/api/badge/server.svg)](https://claudeers.com/server)

// retro hit counter

server hit counter
[![Hits](https://claudeers.com/api/counter/server.svg)](https://claudeers.com/server)

// reviews

// guestbook

0/500

// related in Uncategorized / Others

🔓

Reverse engineer anything with agents, from app behavior down to native binaries.

// uncategorizedmorluto/⟨TypeScript⟩★ 423,040◷ MIT[ claude ]
🔓

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

// uncategorizedn8n-io/⟨TypeScript⟩★ 209,482◷ NOASSERTION[ claude ]
🔓

The agent engineering platform.

// uncategorizedlangchain-ai/⟨Python⟩★ 148,973◷ MIT[ claude ]
🔓

100+ AI Agent & RAG apps you can actually run — clone, customize, ship.

// uncategorizedShubhamsaboo/⟨Python⟩★ 144,747◷ Apache-2.0[ claude ]

// built by

1 of its contributors also build on official projects — php-sdk

→ see how server connects across the ecosystem