A read-only Go CLI that turns a real Kafka cluster into a shareable Kafka Simulator link, with an MCP server for AI agents.
Documentation: monedula.dev/flock/docs/sim-link
- See your cluster in the simulator: from install to your first link
- The read-only guarantee: every request the tool sends, and the tests that prove none of them writes
connectreference: every flag and exit code- Use the MCP server and its tools
go install github.com/monedula-dev/monedula-sim-link/cmd/monedula-sim-link@latestPrebuilt binaries for Linux, macOS and Windows are on the releases page.
Snapshot two topics of a local cluster and print the playground link that shows them:
monedula-sim-link connect --brokers localhost:9092 --topics orders,paymentsAdd --dry-run to see the cluster shape, the real-to-simulator name tables and the decoded actions before the URL. Add --producers to also show some of the writers: it reads the idempotent and transactional producers (DescribeProducers) whose last write to the selected topics falls in the last 15 minutes (--producers-window changes that), and adds up to four of them to the link, named pid-<producerId>. It is not a list of every writer: a producer with enable.idempotence=false and no transaction has no producer id and never appears, the time compared is the record timestamp of its last batch (the producing client's clock on CreateTime topics, the broker's on LogAppendTime topics, so event-time or historical timestamps can fall outside the window), and brokers keep producer state only for producer.id.expiration.ms (24 hours by default), so a longer window shows nothing extra. It is off by default because it needs READ on each topic and Kafka 2.8 or newer; without it no producer is read. Connect to a secured cluster covers TLS, mTLS and SASL (PLAIN and SCRAM).
connect sends only read requests: ApiVersions, Metadata, ListOffsets, ListGroups, FindCoordinator (the client's lookup of a group's coordinator for DescribeGroups and OffsetFetch), DescribeGroups, OffsetFetch and DescribeConfigs, and DescribeProducers only when you pass --producers. Metadata goes out with AllowAutoTopicCreation=false, so looking up a topic never creates it. It joins no consumer group and commits no offset. The whole client is in snapshot/kafka.go, so the guarantee can be audited in one file.
monedula-sim-link mcp serves the Model Context Protocol over stdio, so Claude Code, Claude Desktop or another MCP client can build links: scenario deep links, free-play sessions from a description, and a live cluster snapshotted read-only. A free-play session can include a Schema Registry and, as a v2.2 preview, its failures: SR instances per DC and the kill_sr, restart_sr, sr_failover, restart_producer and set_sr_eligibility actions. From v2.2 it can also run on a diskless implementation (inkless-3az, kafscale-3b on KafScale 2.0, automq-3az), stop and start its PostgreSQL or etcd, pause and resume a KafScale broker, and stop, slow and start its object storage (docs/mapping.md). Ahead of simulator v3.0 (release stage next, not on the public playground yet), it also builds the Streamhouse cluster (streamhouse: Kafka Connect and an Apache Iceberg sink), with its sink settings, Iceberg table operations and Connect worker and connector restarts. In Claude Code:
claude mcp add monedula-sim-link -- monedula-sim-link mcpThe model that drives an MCP client picks the tool arguments, and text it reads can steer it. So credentials stay with the server, set where you register it:
--ca-cert,--client-certand--client-keyare flags ofmcp, never tool arguments, and turn TLS on for everycluster_to_urlcall.--allowed-brokers host:port,...limitscluster_to_urlto those bootstrap brokers. The client certificate needs it, and theMONEDULA_SIM_LINK_PASSWORDpassword is only sent to brokers on it.
claude mcp add monedula-sim-link -e MONEDULA_SIM_LINK_PASSWORD=... -- \
monedula-sim-link mcp --ca-cert /path/ca.pem --allowed-brokers kafka-1:9093,kafka-2:9093With Go 1.26 or newer:
git clone https://github.com/monedula-dev/monedula-sim-link.git
cd monedula-sim-link
go build ./cmd/monedula-sim-link
go test ./...go test ./... needs no Kafka: the integration tests run against an in-process fake cluster (franz-go's kfake). e2e/ runs the same pipeline against a real three-node KRaft cluster in Docker with e2e/run.sh, and checks that nothing on the cluster changed. CI runs it against Apache Kafka 4.3.1 and 3.9.2, Confluent Platform 8.3.2 and 7.9.10, and Confluent Server 8.3.2.
Report bugs and request features in GitHub issues.
monedula-sim-link is licensed under the Apache License 2.0; see LICENSE.
Apache Kafka, Kafka and the Kafka logo are trademarks of The Apache Software Foundation. monedula-sim-link is an independent project that works with Kafka clusters; it is not affiliated with, endorsed by or sponsored by the ASF.