mcp-debezium

Model Context Protocol 서버로, Debezium(Kafka Connect REST API 경유)용입니다. MCP 지원 클라이언트(Claude Desktop, Claude Code 등)에서 CDC(변경 데이터 캡처) 커넥터를 모니터링하고 관리할 수 있습니다. 상태, 구성, 재시작, 수명 주기 — 모든 동작은 전적으로 플래그에 의해 제어됩니다.

기본적으로 안전하게 동작합니다. 읽기 전용으로 시작하며, 커넥터 허용 목록으로 범위를 제한할 수 있고, 중요 커넥터를 변경·삭제로부터 보호하며, 커넥터 구성에서 자격 증명을 가리고, 삭제는 명시적 동의(opt-in)가 있어야만 허용됩니다.

기능

• 모니터링 — 워커/클러스터 정보, 커넥터 목록, 커넥터별 구성, 상태(실패한 태스크 추적 포함), 토픽.

• 관리 — 생성/수정, 일시 중지/재개, 커넥터 또는 단일 태스크 재시작.

• 수명 주기 — 커넥터 삭제(admin).

• 접근 모드 — read-only → read-write → admin으로 계층화되어, 어떤 모드도 자신보다 높은 수준의 도구를 노출하지 않습니다.

• 자격 증명 가림 — 결과가 반환되기 전에 database.password 및 기타 비밀 형식의 구성 값이 ***REDACTED***로 대체됩니다.

• 보안 플래그 — 커넥터 허용 목록, 보호된 커넥터, 삭제 게이팅, dry-run, JSON 감사 로깅(아래 참조).

Related MCP server: Kafka MCP Server

보안 모델

도구

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

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

관리자 (admin): delete_connector (DEBEZIUM_ALLOW_DELETE 필요)

MCP 클라이언트와 함께 사용

Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code(Copilot) 및 기타 모든 MCP 클라이언트와 함께 작동합니다. 클라이언트별 설정은 docs/CLIENTS.md 를 참고하세요.

설치

npm install
npm run build

Claude Desktop / Claude Code로 실행

{
  "mcpServers": {
    "debezium": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-debezium/dist/index.js"],
      "env": {
        "CONNECT_URL": "http://connect:8083",
        "DEBEZIUM_MODE": "read-only",
        "DEBEZIUM_PROTECTED_CONNECTORS": "pg-prod-orders"
      }
    }
  }
}

예시 프롬프트

• "어떤 커넥터가 FAILED 상태이며, 그 이유는 무엇인가요?"

• "pg-orders의 실패한 태스크를 재시작하세요." (read-write 필요)

• "mysql-inventory의 구성을 보여주세요." (자격 증명은 가려진 상태로 반환됩니다)

개발

npm run dev
npm test          # security policy + config redaction
npm run typecheck

배포

이 서버에는 공식 MCP 레지스트리용 server.json과 npm 소유권 검증용 mcpName이 포함되어 있습니다. npm에 배포하고 MCP 레지스트리, Smithery, Glama, Cursor, PulseMCP에 등록하는 방법은 PUBLISHING.md 를 참조하세요.

라이선스

MIT