Labsco
aywengo logo

Kafka Schema Registry

★ 31

from aywengo

A comprehensive Message Control Protocol (MCP) server for Kafka Schema Registry.

🔥🔥🔥🔥✓ VerifiedFreeAdvanced setup
#email#automation#cloud#devops#git#security

Trust Score

Kafka Schema Registry MCP Server

A comprehensive Model Context Protocol (MCP) server that provides Claude Desktop and other MCP clients with tools for Kafka Schema Registry operations. Features advanced schema context support, multi-registry management, and comprehensive schema export capabilities.

Kafka Schema Registry MCP Logo

🎯 True MCP Implementation: Uses modern FastMCP 2.8.0+ framework with full MCP 2025-06-18 specification compliance. Fully compatible with Claude Desktop and other MCP clients using JSON-RPC over stdio.

Latest Version: v2.1.5 | Docker: aywengo/kafka-schema-reg-mcp:stable

📋 Table of Contents

✨ Key Features

  • 🤖 Claude Desktop Integration - Direct MCP integration with natural language interface
  • 🏢 Multi-Registry Support - Manage up to 8 Schema Registry instances simultaneously
  • 📋 Schema Contexts - Logical grouping for production/staging environment isolation
  • 🔄 Schema Migration - Cross-registry migration with backup and verification
  • 📊 Comprehensive Export - JSON, Avro IDL formats for backup and documentation
  • 🔒 Production Safety - VIEWONLY mode and per-registry access control
  • 🔐 OAuth 2.1 Authentication - Enterprise-grade security with scope-based permissions
  • 📈 Real-time Progress - Async operations with progress tracking and cancellation
  • 🔗 Resource Linking - HATEOAS navigation with enhanced tool responses
  • 🧪 Full MCP Compliance - 50+ tools following MCP 2025-06-18 specification
  • 🚀 SLIM_MODE - Reduce tool overhead from 50+ to ~9 essential tools for better LLM performance

📖 See detailed feature descriptions: docs/api-reference.md

🛠️ Claude Code Skills

This project includes 5 specialized Claude Code skills – 4 for automated schema development workflows plus 1 for schema context comparison (/context-compare, documented below):

Available Skills

  • /schema-generate - Generate production-ready Avro schemas from natural language

    /schema-generate event UserRegistered "user registration with userId, email, timestamp"

  • /schema-evolve - Safely evolve schemas with automatic compatibility checking

    /schema-evolve user-profile "add optional phoneNumber field"

  • /migration-plan - Create detailed migration plans between environments

    /migration-plan development staging

  • /lint-and-test - Automated quality assurance workflows

    /lint-and-test quick        # Before commit (2-3s)
/lint-and-test fix          # Auto-fix issues (20-30s)
/lint-and-test pre-push     # Before push (10-15s)

Getting Started with Skills

Quick Start: Read .claude-code/SKILLS_GUIDE.md - 5-minute tutorial

Complete Reference: .claude-code/skills/README.md - Full documentation

Setup Summary: .claude-code/skills/README.md - Configuration details

Skills Features

  • ✅ Natural language schema generation with templates
  • ✅ Automatic compatibility checking (BACKWARD, FORWARD, FULL)
  • ✅ Migration planning with rollback procedures
  • ✅ Pre-commit and pre-push quality automation
  • ✅ Integration with Black, Ruff, isort, Flake8
  • ✅ Docker-based test execution
  • ✅ Comprehensive error handling and auto-fix

Try it now: /schema-generate event TestEvent "test with id and timestamp"

📊 MCP Tools and Resources

This section provides a comprehensive analysis of all MCP tools and resources exposed by the Kafka Schema Registry MCP Server.

Backward Compatibility Wrapper Tools

These tools are maintained for backward compatibility with existing clients. They internally use efficient implementations but are exposed as tools to prevent "Tool not listed" errors. Consider migrating to the corresponding resources for better performance.

Tool NameSLIM_MODEScopeRecommended ResourceDescription
list_registries✅readregistry://namesList all configured registries
get_registry_info✅readregistry://info/{name}Get registry information
test_registry_connection✅readregistry://status/{name}Test registry connection
test_all_registries✅readregistry://statusTest all registry connections
list_subjects✅readregistry://{name}/subjectsList all subjects
get_schema✅readschema://{name}/{context}/{subject}Get schema content
get_schema_versions✅readschema://{name}/{context}/{subject}/versionsGet schema versions
get_global_config✅readregistry://{name}/configGet global configuration
get_mode✅readregistry://modeGet registry mode
list_contexts✅readregistry://{name}/contextsList all contexts
get_subject_config✅readsubject://{name}/{context}/{subject}/configGet subject configuration
get_subject_mode✅readsubject://{name}/{context}/{subject}/modeGet subject mode

Core MCP Tools

CategoryNameTypeSLIM_MODEScopeDescription
CorepingTool✅readMCP ping/pong health check
Registry Managementset_default_registryTool✅adminSet default registry
Registry Managementget_default_registryTool✅readGet current default registry
Schema Operationsregister_schemaTool✅writeRegister new schema version
Schema Operationscheck_compatibilityTool✅readCheck schema compatibility
Context Managementcreate_contextTool✅writeCreate new context
Context Managementdelete_contextTool❌adminDelete context
Subject Managementdelete_subjectTool❌adminDelete subject and versions
Configurationupdate_global_configTool❌adminUpdate global configuration
Configurationupdate_subject_configTool❌adminUpdate subject configuration
Configurationadd_subject_aliasTool❌writeCreate alias subject pointing to an existing subject
Configurationdelete_subject_aliasTool❌writeRemove an alias subject
Mode Managementupdate_modeTool❌adminUpdate registry mode
Mode Managementupdate_subject_modeTool❌adminUpdate subject mode
Statisticscount_contextsTool✅readCount contexts
Statisticscount_schemasTool✅readCount schemas
Statisticscount_schema_versionsTool✅readCount schema versions
Statisticsget_registry_statisticsTool❌readGet comprehensive registry stats
Exportexport_schemaTool✅readExport single schema
Exportexport_subjectTool✅readExport all subject versions
Exportexport_contextTool❌readExport all context subjects
Exportexport_globalTool❌readExport all contexts/schemas
Exportexport_global_interactiveTool❌readInteractive global export
Migrationmigrate_schemaTool❌adminMigrate schema between registries
Migrationmigrate_contextTool❌adminMigrate context between registries
Migrationmigrate_context_interactiveTool❌adminInteractive context migration
Comparisoncompare_registriesTool❌readCompare two registries
Comparisoncompare_contexts_across_registriesTool❌readCompare contexts across registries
Comparisonfind_missing_schemasTool❌readFind missing schemas
Batch Operationsclear_context_batchTool❌adminClear context with batch operations
Batch Operationsclear_multiple_contexts_batchTool❌adminClear multiple contexts
Interactiveregister_schema_interactiveTool❌writeInteractive schema registration
Interactivecheck_compatibility_interactiveTool❌readInteractive compatibility check
Interactivecreate_context_interactiveTool❌writeInteractive context creation
Resource Discoverylist_available_resourcesTool✅readList all available resources
Resource Discoverysuggest_resource_for_toolTool✅readGet resource migration suggestions
Resource Discoverygenerate_resource_templatesTool✅readGenerate resource URI templates
Elicitationsubmit_elicitation_responseTool❌writeSubmit elicitation response
Elicitationlist_elicitation_requestsTool❌readList elicitation requests
Elicitationget_elicitation_requestTool❌readGet elicitation request details
Elicitationcancel_elicitation_requestTool❌adminCancel elicitation request
Elicitationget_elicitation_statusTool❌readGet elicitation system status
Workflowslist_available_workflowsTool❌readList available workflows
Workflowsget_workflow_statusTool❌readGet workflow status
Workflowsguided_schema_migrationTool❌adminStart schema migration wizard
Workflowsguided_context_reorganizationTool❌adminStart context reorganization wizard
Workflowsguided_disaster_recoveryTool❌adminStart disaster recovery wizard
Utilityget_mcp_compliance_status_toolTool❌readGet MCP compliance status
Utilityget_oauth_scopes_info_toolTool❌readGet OAuth scopes information
Utilitytest_oauth_discovery_endpointsTool❌readTest OAuth discovery endpoints
Utilityget_operation_info_toolTool❌readGet operation metadata
Utilitycheck_viewonly_modeTool❌readCheck if registry is in viewonly mode
RESOURCESregistry://statusResource✅readOverall registry connection status
RESOURCESregistry://infoResource✅readDetailed server configuration
RESOURCESregistry://modeResource✅readRegistry mode detection
RESOURCESregistry://namesResource✅readList of configured registry names
RESOURCESregistry://status/{name}Resource✅readSpecific registry connection status
RESOURCESregistry://info/{name}Resource✅readSpecific registry configuration
RESOURCESregistry://mode/{name}Resource✅readSpecific registry mode
RESOURCESregistry://{name}/subjectsResource✅readList subjects for registry
RESOURCESregistry://{name}/contextsResource✅readList contexts for registry
RESOURCESregistry://{name}/configResource✅readGlobal config for registry
RESOURCESschema://{name}/{context}/{subject}Resource✅readSchema content with context
RESOURCESschema://{name}/{subject}Resource✅readSchema content default context
RESOURCESschema://{name}/{context}/{subject}/versionsResource✅readSchema versions with context
RESOURCESschema://{name}/{subject}/versionsResource✅readSchema versions default context
RESOURCESsubject://{name}/{context}/{subject}/configResource✅readSubject config with context
RESOURCESsubject://{name}/{subject}/configResource✅readSubject config default context
RESOURCESsubject://{name}/{context}/{subject}/modeResource✅readSubject mode with context
RESOURCESsubject://{name}/{subject}/modeResource✅readSubject mode default context
RESOURCESelicitation://response/{request_id}Resource❌writeElicitation response handling

🔒 Authentication & Security

OAuth 2.1 Support (Optional)

# Enable authentication
export ENABLE_AUTH=true
export AUTH_ISSUER_URL="https://your-oauth-provider.com"
export AUTH_AUDIENCE="your-client-id"

Supported Providers: Azure AD, Google OAuth, Keycloak, Okta, GitHub

Permission Scopes:

  • read - View schemas, configurations
  • write - Register schemas, update configs (includes read)
  • admin - Delete subjects, full control (includes write + read)

Production Safety Features

  • VIEWONLY Mode - Prevent accidental changes in production
  • URL Validation - SSRF protection with configurable localhost access
  • Scope-based Authorization - Fine-grained tool-level permissions
  • Per-Registry Controls - Independent safety settings

📖 Security guide: docs/deployment.md#security

📚 Documentation

GuideDescription
API ReferenceComplete tool documentation with examples
Subject AliasingHow to add and remove subject aliases
Use CasesReal-world scenarios and implementation patterns
Deployment GuideDocker, Kubernetes, cloud platforms, CI/CD
IDE IntegrationVS Code, Claude Code, Cursor setup
Configuration ExamplesReady-to-use Claude Desktop configs
Testing GuideComprehensive testing setup
ChangelogVersion history and migration notes
v2.0.0 HighlightsMajor version features

Additional Resources

  • Examples - Usage examples and code samples
  • Scripts - Utility scripts and automation
  • Helm Charts - Kubernetes deployment
  • Tests - Test suites and validation

🧪 Testing

Quick Test

cd tests/
./run_all_tests.sh --quick    # Essential tests
./run_all_tests.sh           # Complete test suite

Docker Testing

python tests/test_docker_mcp.py

MCP Inspector Tests (UI-driven)

# From repository root
cd inspector-tests

# Single registry (DEV)
./run-inspector-tests.sh stable

# Multi-registry (DEV + PROD)
./run-inspector-tests.sh multi

# Test a specific Docker tag
DOCKER_VERSION=latest ./run-inspector-tests.sh stable

📖 Testing guide: TESTING_SETUP_GUIDE.md

🤝 Contributing

We welcome contributions! Please see:

Quick Development Setup

git clone https://github.com/aywengo/kafka-schema-reg-mcp
cd kafka-schema-reg-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python kafka_schema_registry_unified_mcp.py

🆕 What's New

v2.1.x (Latest)

  • 🧭 Subject Aliasing - New tools add_subject_alias and delete_subject_alias
  • 🛠️ Fixes - Evolution assistant and import interactive fixes
  • 📦 Enhancements - Continued MCP tool refinements and testing improvements
  • 🗑️ Removed Deprecated Tools - Custom task management tools removed in favor of FastMCP's built-in Docket system

v2.0.x

  • 🔒 Security Fixes - Resolved credential exposure in logging
  • 🤖 Interactive Schema Migration - Smart migration with user preference elicitation
  • 💾 Automatic Backups - Pre-migration backup creation
  • ✅ Post-Migration Verification - Comprehensive schema validation
  • 🚀 FastMCP 2.8.0+ Framework - Complete architecture upgrade
  • 📊 MCP 2025-06-18 Compliance - Latest protocol specification
  • 🔐 OAuth 2.1 Generic Discovery - Universal provider compatibility
  • 🔗 Resource Linking - HATEOAS navigation in tool responses

📖 Full changelog: CHANGELOG.md | 📖 v2.0.0 features: README-v2.0.0-HIGHLIGHTS.md

🐳 Glama.ai:

🐳 Docker Hub: aywengo/kafka-schema-reg-mcp | 📊 Stats: 50+ MCP Tools (12 backward compatibility), 19 Resources, 8 Registries, OAuth 2.1, Multi-platform

License: MIT | Maintainer: @aywengo | Issues: GitHub Issues