Mcp Debezium

io.github.dockndevaiPublished by GitHub account dockndevaiv0.3.0Updated Nov 17, 2026

Debezium / Kafka Connect CDC connector management for AI agents — governed, secret-safe.

Overview

AI-generated overview

MCP server for monitoring and managing Debezium CDC connectors through the Kafka Connect REST API, with read-only defaults and credential redaction.

What you can do
  • Inspect the Connect cluster, list connectors and plugins, and read a connector's config, status with failed-task traces, and topics
  • Create and update connector configs, pause and resume connectors, and restart a connector or a single task
  • Delete connectors in admin mode when deletion is explicitly enabled
  • Redact secret-shaped config values and log guarded operations to an audit trail
  • Gate destructive actions behind human approval prompts and dry-run previews
When to use it
Useful when you run Debezium or Kafka Connect and want an assistant to answer questions about failing connectors, show redacted configs, or perform restarts and lifecycle changes under a controlled access mode.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires CONNECT_URL pointing at the Kafka Connect REST API. Optional variables set the access mode (DEBEZIUM_MODE, default read-only), connector allowlist, protected connectors, delete gating, dry-run and audit logging. Network access to the Connect endpoint is required.
Before you install
Write and admin tools change live CDC pipelines: create, update, pause, resume, restart and delete. Deletion needs both admin mode and DEBEZIUM_ALLOW_DELETE. Keep the default read-only mode unless changes are intended, and use the allowlist, protected connectors and human-approval settings. Connector configs may contain database credentials; redaction is applied to returned values, but the server itself still talks to Connect with whatever access that endpoint grants.

Installation

In SourceWeft

  1. Open Mcp Debezium in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-debezium

[CI] [License: MIT] [npm]

A Model Context Protocol server for Debezium (via the Kafka Connect REST API). It lets an MCP-capable client (Claude Desktop, Claude Code, etc.) monitor and manage change-data-capture connectors — status, config, restarts, lifecycle — with behaviour controlled entirely by flags.

Safe by default: it starts read-only, can be scoped to an allowlist of connectors, protects critical connectors from mutation, redacts credentials in connector configs, and gates deletion behind an explicit opt-in.

Features

  • Monitoring — worker/cluster info, connector list, plugins, per-connector config, status (with failed-task traces), and topics.
  • Management — create/update, pause/resume, restart connector or a single task.
  • Lifecycle — delete connectors (admin).
  • Access modes — read-only → read-write → admin, layered so a mode never exposes tools above its level.
  • Credential redaction — database.password and other secret-shaped config values are replaced with ***REDACTED*** before results are returned.
  • Security flags — connector allowlist, protected connectors, delete gating, dry-run, and JSON audit logging (see below).

Security model

ConcernFlagDefaultEffect
What can the server do?DEBEZIUM_MODEread-onlyread-only exposes monitoring only; read-write adds lifecycle management; admin adds delete. Tools above the mode are never registered.
Which connectors are in scope?DEBEZIUM_CONNECTOR_ALLOWLIST(all)When set, operations on other connectors are refused.
Which connectors are read-only forever?DEBEZIUM_PROTECTED_CONNECTORS(none)Inspectable but never paused/reconfigured/deleted.
Can it delete?DEBEZIUM_ALLOW_DELETEfalsedelete_connector needs this and admin mode.
Preview without touching ConnectDEBEZIUM_DRY_RUNfalseWrite/admin tools validate + log intent, then return.
Audit trailDEBEZIUM_AUDIT_LOGtrueEmits a JSON line to stderr per guarded operation.
Interactive confirmation(automatic)—Destructive & high-impact actions prompt the human to approve via MCP elicitation before running. The prompt shows the tool, the exact (secret-redacted) arguments and a fingerprint (for update_connector_config a redacted current → new config diff, for create_connector the redacted config); the target's version is pinned across the prompt and the action is refused if it changed; a prompt nobody answers is a refusal.
Require a humanDEBEZIUM_REQUIRE_HUMAN_APPROVALfalseWhen true, delete_connector, create_connector and update_connector_config are refused if the client cannot elicit (instead of falling back to the *_ALLOW_* gate alone).
Credential redaction(always on)—Secret-shaped config values are redacted before return.

Tools

Read (read-only+): cluster_info, list_connectors, list_connector_plugins, get_connector, get_connector_config, get_connector_status, get_connector_topics

Write (read-write+): create_connector, update_connector_config, pause_connector, resume_connector, restart_connector, restart_task

Admin (admin): delete_connector (needs DEBEZIUM_ALLOW_DELETE)

Quickstart — add to your agent

Published on npm as @dockndevai/mcp-debezium. No clone or build needed — your MCP client runs it on demand with npx. Start in read-only mode; see .env.example for every variable and docs/CLIENTS.md for the full per-client guide.

Claude Code (CLI)

bash
claude mcp add debezium -e CONNECT_URL="http://localhost:8083" -e DEBEZIUM_MODE="read-only" -- npx -y @dockndevai/mcp-debezium

Claude Desktop · Cursor · Windsurf — same block in claude_desktop_config.json, .cursor/mcp.json, or ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "debezium": {      "command": "npx",      "args": [        "-y",        "@dockndevai/mcp-debezium"      ],      "env": {        "CONNECT_URL": "http://localhost:8083",        "DEBEZIUM_MODE": "read-only"      }    }  }}

OpenAI Codex CLI — in ~/.codex/config.toml:

toml
[mcp_servers.debezium]command = "npx"args = ["-y", "@dockndevai/mcp-debezium"]env = { CONNECT_URL = "http://localhost:8083", DEBEZIUM_MODE = "read-only" }

VS Code (GitHub Copilot, Agent mode) — in .vscode/mcp.json:

json
{  "servers": {    "debezium": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "@dockndevai/mcp-debezium"      ],      "env": {        "CONNECT_URL": "http://localhost:8083",        "DEBEZIUM_MODE": "read-only"      }    }  }}

Example prompts

  • "Which connectors are FAILED, and why?"
  • "Restart the failed task on pg-orders." (needs read-write)
  • "Show the config for mysql-inventory." (credentials come back redacted)

Run from source (development)

Prefer the published package above. To run from a clone:

bash
npm installnpm run buildnode dist/index.js   # with the environment variables set

Develop

bash
npm run devnpm test          # security policy + config redactionnpm run typecheck

Publishing

This server ships a server.json for the official MCP registry and an mcpName for npm ownership validation. See PUBLISHING.md for publishing to npm and listing on the MCP registry, Smithery, Glama, Cursor, and PulseMCP.

License

MIT

Source: README.md at commit 3f10c15

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.3.0LatestSep 29, 2026
  2. v0.2.2Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts