Rahdar MCP server
Commit 15 Nov 2026Menyediakan konsol operasi terpadu untuk mengelola cluster Apache Artemis, Kafka, dan RabbitMQ dengan estimasi consumer lag dan approval gate.
Juga dikenal sebagai sudoitir/rahdar
- Stars
- 10
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 15 Nov 2026
- Lisensi
- Apache-2.0
Apa itu Rahdar MCP?
Menyediakan konsol operasi terpadu untuk mengelola cluster Apache Artemis, Kafka, dan RabbitMQ dengan estimasi consumer lag dan approval gate.
Ringkasan dibuat dari README proyek
Tentang Rahdar MCP server
Mengelola banyak messaging cluster melalui terminal terpisah dan konsol manajemen individual adalah hal yang disederhanakan oleh Rahdar untuk DevOps engineer dan tim site reliability. Rahdar menyediakan satu estate operasi tunggal untuk memantau Apache ActiveMQ Artemis, Apache Kafka, dan RabbitMQ secara berdampingan. Dengan mengonsolidasikan berbagai sistem ini ke dalam satu tampilan, Anda dapat melacak kesehatan dan backlog di seluruh infrastruktur tanpa perlu berpindah-pindah tool.
Server ini berfungsi sebagai konsol terpadu yang terhubung ke broker Anda yang sudah ada melalui OpenBroker SDK. Rahdar tidak menjalankan atau mengelola broker itu sendiri; sebagai gantinya, Anda mendaftarkan cluster yang sudah ada di dalam interface. Untuk keamanan dan stabilitas, sistem ini menyertakan approval gate untuk tindakan destruktif, yang memerlukan konfirmasi dari orang kedua untuk menyetujui perubahan. Sistem ini juga menyediakan preview untuk operasi seperti offset reset guna menunjukkan secara tepat apa yang akan terjadi sebelum perintah dijalankan.
Setup melibatkan menjalankan service bersama dengan database PostgreSQL 18, yang bisa berupa container lokal atau instance managed eksternal. Sistem ini melacak Kafka consumer group lag sebagai estimasi dan memberikan pengukuran depth yang akurat untuk queue Artemis, memastikan Anda memahami reliabilitas data yang ditampilkan.
Apa yang bisa Anda lakukan dengannya
- 1Monitor backlog pesan lintas clusterDeveloper dapat melihat semua queue Artemis dan Kafka consumer group dalam satu tabel yang diurutkan berdasarkan backlog terbesar.
- 2Melakukan Kafka offset reset yang amanEngineer dapat melihat preview berapa banyak record yang akan dilewati di setiap partition sebelum melakukan commit pada offset reset.
- 3Menyelesaikan Kafka transaction yang menggantungOperator dapat mengidentifikasi transaksi yang menggantung dan melihat partition mana saja yang akan terbuka kembali sebelum melakukan abort.
- 4Audit topologi dan kesehatan clusterUser dapat memverifikasi status replikasi dan peran high availability pada cluster Artemis.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkausudoitir/rahdar is public and reachablegithub.com/sudoitir/rahdar ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-14github.com/sudoitir/rahdar ↗Lolos
- OpenSSF ScorecardOpenSSF Scorecard 6.9 / 10; weakest: Maintained 0, Code-Review 0, CII-Best-Practices 0scorecard.dev/viewer/?uri=github.com/sudoitir/rahdar ↗Parsial 10/15
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubRahdar
Rahdar (Persian راهدار, "road-keeper") is rah (route) + dar (keeper): it keeps every route your messages travel open and safe.
One open-source console for your Apache ActiveMQ® Artemis, Apache Kafka® and RabbitMQ clusters.
Every cluster you run in one estate, lag shown as the estimate it is, a preview before anything destructive, and an approval gate that holds people and assistants alike.
An interactive on-call night · about 2 minutes · runs in your browser
Docs · Quickstart · Kafka · RabbitMQ · Flow · SQL Console · MCP · Discussions
[!WARNING] Alpha. Under active development and not yet feature-complete. Published images are pre-stable dev builds (
sudoit1/rahdar:dev; there is no:latestyet). Expect breaking changes.
Every cluster in one estate: Artemis and Kafka side by side, the worst backlog first.
Quickstart
Rahdar and its Postgres, from the published image. Your brokers stay as they are: you register them in the UI, and nothing here starts one.
base=https://raw.githubusercontent.com/sudoitir/rahdar/main/deploy/compose
mkdir -p rahdar/compose rahdar/postgres && cd rahdar/compose # the compose file mounts ../postgres
curl -sO "$base/compose.prod.yaml"
for f in postgresql.conf 10-pg-stat-statements.sql; do curl -s "${base%/compose}/postgres/$f" -o "../postgres/$f"; done
curl -s "$base/.env.example" | sed \
-e "s|^SECRET_KEY=.*|SECRET_KEY=$(openssl rand -base64 32)|" \
-e "s|^DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -hex 24)|" > .env
docker compose -f compose.prod.yaml --env-file .env up -d
docker compose -f compose.prod.yaml logs rahdar | grep -A4 'Created administrator'
Open http://localhost:8080 and sign in as admin with the password the last line
prints. It is shown once: you choose your own at the first sign-in, and set up two-step verification, which the
admin role requires.
git clone https://github.com/sudoitir/rahdar && cd rahdar
just up # two replicas behind HAProxy, pinned to the latest release (just up-single: one replica)
docker run -p 8080:8080 \
-e RAHDAR_DB_URL=jdbc:postgresql://db:5432/rahdar \
-e RAHDAR_DB_USER=rahdar \
-e RAHDAR_DB_PASSWORD=... \
-e RAHDAR_SECRET_KEY="$(openssl rand -base64 32)" \
sudoit1/rahdar:dev
Rahdar runs on a managed or highly available PostgreSQL 18 too, in a schema of your choosing and as a role that is not a superuser: see Running Rahdar on an external PostgreSQL.
Every variable, what a reverse proxy needs for the SSE stream, and how to recover a lost first login are in the configuration guide.
Hardware requirements
Measured with a load test on a 4 vCPU / 8 GB machine, Postgres on the same host (sizing guide, which also lists what each size carries and what degrades first). Sizes per host:
| Minimum | Recommended | |
|---|---|---|
| Rahdar node (single instance, or each replica of a replicated deployment) | 2 vCPU, 2 GB | 4 vCPU, 4 GB |
| PostgreSQL 18 (single instance, or the shared server of a replicated deployment) | 2 vCPU, 2 GB, SSD | 4 vCPU, 4 GB, SSD |
A replicated deployment runs two or more Rahdar nodes of that size on one Postgres of that size. The minimum is the observed peak (a Rahdar
replica 1.3 GiB and about 1.2 cores, Postgres 0.6 GB and one core) with little headroom, derived from the runs on the
reference machine rather than measured on a smaller one. It carries a few clusters of up to four nodes with around a thousand queues per node, a few dozen browsers and
about a hundred event-stream subscribers; the recommended size keeps interactive reads under a second
at 3,000 queues per node and absorbs a burst of sign-ins. CPU is what runs out first, not memory. Postgres
needs about 0.6 GB of its memory for the shipped configuration (deploy/postgres/postgresql.conf); how much
disk depends on how long you keep history. The server requirements and settings of an existing PostgreSQL are in
Running Rahdar on an external PostgreSQL.
Why
It's 02:51 and two things page you at once: a Kafka consumer group is falling behind on
payments, and ORDERS.DLQ is backing up somewhere on an Artemis pair. Without Rahdar
that is a management console tab per Artemis broker, kafka-consumer-groups.sh and
kafka-transactions.sh in a terminal, and your own arithmetic in between.
Rahdar puts every cluster you run in one estate, whatever the broker. Health is judged on one scale, and every backlog is in one table, sorted worst first: Artemis queues and Kafka groups side by side, each under its own name. A number says how sure it is: an Artemis queue's depth is exact, a Kafka group's lag is an estimate with its per-partition breakdown, and a number Rahdar cannot read says so instead of showing zero. Nothing destructive runs before you have seen what it will do, and where the approval gate is on, a second person approves it.
▶ Play the story: find the hanging transaction behind the lag, abort it, reset a group with a held approval, and clear the Artemis dead-letter queue, all in one estate.
What it does
| Kafka lag is an estimate, and opens to every partition, slowest first. | A consumer group's lag per partition and its members. |
| An offset reset is previewed per partition before it is held to confirm. | A hanging transaction, found and aborted with its reach stated first. |
| Registration checks every broker on the address it advertises. | Artemis topology, with HA roles polled from every node. |
Rahdar talks to brokers through OpenBroker, an open-source broker SDK with a driver per system. The screens every system shares (the estate, subscriptions and destinations, browsing, purge, the audit trail, the API and MCP) work on each, in that system's own words, and an action a system cannot do stays visible, disabled, with the reason.
| System | Supported | Guide |
|---|---|---|
| Apache ActiveMQ® Artemis | 2.33.0 and later | Guide |
| Apache Kafka® | 2.8 and later, KRaft and ZooKeeper mode | Kafka |
| RabbitMQ | 3.13 and later (4.x tested) | RabbitMQ |
Details and what happens outside those ranges: supported broker versions.
Apache Kafka
- Consumer groups — classic, consumer and share groups with their state, members and lag. Lag is an estimate and is marked as one: open it for every partition, slowest first, with the committed offset, the end and the sample's age.
- Reset offsets — to the earliest, the latest, a time or an offset, previewed per partition with what the group would skip or read again. A group with members is refused, naming them; the reset runs against the state it previewed, is confirmed by holding, waits for approval where the gate is on, and is audited with the offsets before and after.
- Topic configuration — each setting with where its value comes from, changed through a review that the broker validates before anything applies.
- ACLs — listed, added and removed, with the effective access of each principal before and after the change.
- Transactions — a hanging transaction that holds read-committed consumers back is flagged, and aborting it is previewed, held and audited.
- Brokers and the quorum — every broker, whether Rahdar reached it on its advertised address, and the KRaft controller quorum.
- On the shared screens — browse a topic by partition and offset or time, without joining a group; purge a group's unread records or truncate a topic with its reach stated, including every group that would lose records it has not read.
RabbitMQ
- Registration — management URLs and optional AMQP endpoints with one account; the check reaches every endpoint on its own and names each node, its alarms and any partition.
- Nodes — version, uptime, listeners and plugins, with a memory or disk alarm flagged because it blocks every publisher.
- Virtual hosts, bindings, policies and permissions — each change previewed first, confirmed by holding for the destructive ones, held for approval where the gate is on, and audited. A policy's preview lists the queues and exchanges it matches.
- Shovels and federation — dynamic shovels and federation links with their state, addresses shown without credentials.
- On the shared screens — classic, quorum and stream queues with their backlog marked as an estimate (a stream has none); browse a stream by offset, without removing a message; publish through an exchange and be told when no queue received it. A resource recreated with the same configuration is not told apart, and the confirmation says so.
Apache Artemis
-
Topology — live/backup pairs and their replication state. The HA role is polled from every node on every cycle and never read from configuration; two live nodes in one pair raise a split-brain alert.
-
Flow — which application sends to which address, how that address routes through diverts, bridges and cluster hops into queues, and who consumes them, at what rate. Faults such as a backlog with no consumer are stated in words, and clients are sampled only while someone is watching.
-
SQL Console — Artemis cannot tell you where order 4471 went. Its only server-side filter is a JMS selector: headers only, never the body, one queue on one node at a time. Rahdar can:
SELECT * FROM "ORDER.*" WHERE body->>'orderId' = '4471' LIMIT 50The dialect is read-only
SELECT, checked against a fixed column catalogue, so a query cannot change anything. Header predicates become a JMS selector and cost nothing; body predicates scan, and the cost line under the editor tells you which before the query runs. A query over the cost ceiling is refused with its estimate rather than quietly truncated. Add a live tail, or turn on complete capture for a queue: a broker-bounded copy that Rahdar drains, so a message consumed between two polls can still be found. -
Cross-node resources — queues, addresses, consumers, sessions, connections and producers in one virtualised table, each row attributed to its node and kept current over SSE.
-
Message operations — browse, send, move, retry, expire, delete and purge. Every mutating call accepts
?dryRun=true, bulk operations are capped on the server, and outcomes are reported per node. -
Request-reply tracing — requests matched to their replies across addresses and nodes, with latency and timeout statistics against the expectations you declare.
-
Broker configuration — declare the address settings, security settings, diverts, bridges and queues a cluster should run, and compose the routing between them on a canvas. Apply them canary-first, with every hazard stated before anything is written, or export them as a
broker.xmlfragment, and see where each node has drifted. On a first run Rahdar offers the cluster's current state as revision 1; nothing is adopted without your say, and a bridge is never adopted because the broker reports only part of one. -
Setup review — each cluster's HA, clustering, durability and message-safety configuration checked against known mistakes: a single replication pair that cannot win a quorum vote, redistribution left at
-1, a connector advertisinglocalhost, no dead-letter address. Every finding carries the evidence per node and thebroker.xmlfix, and can be accepted as a known risk, with a reason, on the record. -
Alert delivery — Slack, Microsoft Teams, PagerDuty (incidents open and resolve with the alert), email and signed webhooks, each tested before it is saved, with a delivery log that says why a notification failed.
-
Data governance — sensitive headers and properties are masked, PII is classified automatically, and redaction follows the viewer's role.
-
Governance — authentication everywhere, roles and permissions scoped global → environment → cluster, API tokens, optional OIDC/SSO, and an audit trail that records every change and its outcome.
-
MCP server — the same capabilities for an AI assistant, under the same grants and the same audit trail. Its eight
kafka_*tools change nothing that was not previewed first, and wait for a person wherever the approval gate is on; sixrabbitmq_*tools read a RabbitMQ cluster. -
Plugins — install a plugin's
.jarfrom the UI: screens, API, assistant tools and data of its own, with everything it can do shown before you confirm, and no restart unless it needs one. Updates show what changes and roll back; a failing plugin never stops Rahdar. Start a plugin from the template.
How it works
Four rules hold everywhere in the product:
- Broker-friendly by construction. Batched reads (on Artemis, one Jolokia POST per node, never one per queue), tiered polling and a per-node rate limiter. Rahdar must never be the reason a broker falls over.
- Safe by default. Every destructive call can dry-run first and states its reach, and purge, delete, truncate and resets are confirmed by pressing and holding a button that names the count.
- State comes from the brokers, not from config. Artemis HA roles are polled from every node, a Kafka cluster's health is formed from its brokers and its quorum, and a RabbitMQ cluster's from its nodes, their alarms and its replicated queues.
- Honest capability gating. An unavailable feature says so and shows the exact
broker.xmlthat enables it. Nothing silently disappears.
Java 25 · Spring Boot 4.1 · PostgreSQL with Liquibase · React 19 + Vite + Mantine 9 · TanStack Router/Query/Table · React Flow · the OpenBroker SDK and its Artemis, Kafka and RabbitMQ drivers · SSE · one container image. Read the architecture and every recorded decision.
Contributing
Questions and ideas go to Discussions,
bugs to issues, and
vulnerabilities to private reporting
(SECURITY.md). To build it, you need JDK 25, Node 24, Docker and
just; a dev container is included.
just dev-up # Postgres + a real Artemis primary/backup pair + a Kafka node + Rahdar, from source
just dev # or: backend :8080 + Vite :5173 together, with live reload
just verify # everything CI runs
ADMIN_PASSWORD=… just demo (the first run also needs NEW_ADMIN_PASSWORD=…, and later ones ADMIN_TOTP_SECRET=…) adds two more live/backup pairs and fills all six nodes
with realistic traffic: diverts, a bridge, cluster hops, a growing backlog with no
consumer, a real dead-letter backlog and one stopped node. It also registers a
three-broker Kafka cluster, events, with groups that keep up and fall behind, a
compacted topic, ACLs and a hanging transaction. The screenshots above are
recorded from that estate; nothing is staged.
Every feature goes through OpenSpec and significant decisions are recorded as
ADRs. Start with CONTRIBUTING.md.
Releases
A merge that changes the application publishes a release, versioned with CalVer
YYYY.MM.PATCH and tagged three ways on Docker Hub: 2026.09.3 (immutable), 2026.09
(that month) and dev (the latest). There is no :latest until the first stable
release. Each release attaches the runnable jar with its .sha256, and its notes are
generated from the commit messages (releases, changelog). The plugin SDK
(npm) is published with the releases that change it; the plugin API and the Java client reach Maven Central
when a maintainer publishes a release there.
Licence
Apache-2.0, the same licence as Artemis and Kafka themselves.
Apache, Apache Kafka, Kafka, Apache ActiveMQ, ActiveMQ and Artemis are trademarks of the Apache Software Foundation; RabbitMQ is a trademark of its owner. Rahdar is not affiliated with or endorsed by them. The names are used only to describe the brokers Rahdar works with.
If this saved you time, a ⭐ helps others find it.
Pertanyaan tentang Rahdar MCP
Apakah Rahdar mengelola instalasi broker?
Tidak, Rahdar tidak menjalankan atau mengelola broker Anda; Anda cukup mendaftarkan broker yang sudah ada ke dalam UI.
Bagaimana Rahdar menangani tindakan destruktif?
Rahdar menyediakan preview untuk tindakan destruktif dan menyertakan approval gate baik untuk manusia maupun AI assistant.
Bagaimana Kafka lag ditampilkan?
Kafka lag ditampilkan sebagai estimasi, termasuk rincian per-partition.