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. Latest Version: v2.1.5 | Docker: aywengo/kafka-schema-reg-mcp:stable - 🚀 Quick Start - ✨ Key Features - 🛠️ Claude Code Skills - 📦
Add this skill
npx mdskills install aywengo/kafka-schema-reg-mcpComprehensive Kafka Schema Registry MCP server with 50+ tools, multi-registry support, and excellent documentation
1[](https://mseep.ai/app/aywengo-kafka-schema-reg-mcp)2[](https://opensource.org/licenses/MIT)3[](https://www.python.org/downloads/)4[](https://hub.docker.com/r/aywengo/kafka-schema-reg-mcp)5[](https://github.com/aywengo/kafka-schema-reg-mcp/releases)6[](https://github.com/aywengo/kafka-schema-reg-mcp/issues)7[](https://hub.docker.com/r/aywengo/kafka-schema-reg-mcp)8[](https://github.com/aywengo/kafka-schema-reg-mcp/graphs/commit-activity)9[](https://modelcontextprotocol.io)10[](https://archestra.ai/mcp-catalog/aywengo__kafka-schema-reg-mcp)1112# Kafka Schema Registry MCP Server1314A 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.1516<table width="100%">17<tr>18<td width="33%" style="vertical-align: top;">19<div style="background-color: white; padding: 20px; border-radius: 10px;">20 <img src="docs/logo_400_mcp_kafka_schema_reg.png" alt="Kafka Schema Registry MCP Logo" width="100%">21</div>22</td>23<td width="67%" style="vertical-align: top; padding-left: 20px;">2425> **🎯 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`.2627**Latest Version:** [v2.1.5](CHANGELOG.md) | **Docker:** `aywengo/kafka-schema-reg-mcp:stable`28</td>29</tr>30</table>3132## 📋 Table of Contents3334- [🚀 Quick Start](#-quick-start)35- [✨ Key Features](#-key-features)36- [🛠️ Claude Code Skills](#️-claude-code-skills)37- [📦 Installation](#-installation)38- [⚙️ Configuration](#️-configuration)39- [💬 Usage Examples](#-usage-examples)40- [🔒 Authentication & Security](#-authentication--security)41- [📚 Documentation](#-documentation)42- [🧪 Testing](#-testing)43- [🚀 Deployment](#-deployment)44- [🤝 Contributing](#-contributing)45- [🆕 What's New](#-whats-new)4647## 🚀 Quick Start4849### 1. Run with Docker (Recommended)50```bash51# Latest stable release52docker pull aywengo/kafka-schema-reg-mcp:stable5354# Recommended: Run with SLIM_MODE for optimal performance (reduced essential tool set)55docker run -e SCHEMA_REGISTRY_URL=http://localhost:8081 -e SLIM_MODE=true aywengo/kafka-schema-reg-mcp:stable5657# OR run with full feature set for administrators/SRE58docker run -e SCHEMA_REGISTRY_URL=http://localhost:8081 aywengo/kafka-schema-reg-mcp:stable59```6061### 2. Configure Claude Desktop62Copy a ready-to-use configuration from [`config-examples/`](config-examples/):6364```bash65# macOS66cp config-examples/claude_desktop_stable_config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json6768# Linux69cp config-examples/claude_desktop_stable_config.json ~/.config/claude-desktop/config.json70```7172### 3. Start Using with Claude73Restart Claude Desktop and try these prompts:74- *"List all schema contexts"*75- *"Show me the subjects in the production context"*76- *"Register a new user schema with fields for id, name, and email"*7778## ✨ Key Features7980- **🤖 Claude Desktop Integration** - Direct MCP integration with natural language interface81- **🏢 Multi-Registry Support** - Manage up to 8 Schema Registry instances simultaneously82- **📋 Schema Contexts** - Logical grouping for production/staging environment isolation83- **🔄 Schema Migration** - Cross-registry migration with backup and verification84- **📊 Comprehensive Export** - JSON, Avro IDL formats for backup and documentation85- **🔒 Production Safety** - VIEWONLY mode and per-registry access control86- **🔐 OAuth 2.1 Authentication** - Enterprise-grade security with scope-based permissions87- **📈 Real-time Progress** - Async operations with progress tracking and cancellation88- **🔗 Resource Linking** - HATEOAS navigation with enhanced tool responses89- **🧪 Full MCP Compliance** - 50+ tools following MCP 2025-06-18 specification90- **🚀 SLIM_MODE** - Reduce tool overhead from 50+ to ~9 essential tools for better LLM performance9192> **📖 See detailed feature descriptions**: [docs/api-reference.md](docs/api-reference.md)9394## 🛠️ Claude Code Skills9596This project includes **5 specialized Claude Code skills** – 4 for automated schema development workflows plus 1 for schema context comparison (`/context-compare`, documented below):9798### Available Skills99100- **`/schema-generate`** - Generate production-ready Avro schemas from natural language101 ```102 /schema-generate event UserRegistered "user registration with userId, email, timestamp"103 ```104105- **`/schema-evolve`** - Safely evolve schemas with automatic compatibility checking106 ```107 /schema-evolve user-profile "add optional phoneNumber field"108 ```109110- **`/migration-plan`** - Create detailed migration plans between environments111 ```112 /migration-plan development staging113 ```114115- **`/lint-and-test`** - Automated quality assurance workflows116 ```117 /lint-and-test quick # Before commit (2-3s)118 /lint-and-test fix # Auto-fix issues (20-30s)119 /lint-and-test pre-push # Before push (10-15s)120 ```121122### Getting Started with Skills123124**Quick Start:** Read [`.claude-code/SKILLS_GUIDE.md`](.claude-code/SKILLS_GUIDE.md) - 5-minute tutorial125126**Complete Reference:** [`.claude-code/skills/README.md`](.claude-code/skills/README.md) - Full documentation127128**Setup Summary:** [`.claude-code/skills/README.md`](.claude-code/skills/README.md) - Configuration details129130### Skills Features131132- ✅ Natural language schema generation with templates133- ✅ Automatic compatibility checking (BACKWARD, FORWARD, FULL)134- ✅ Migration planning with rollback procedures135- ✅ Pre-commit and pre-push quality automation136- ✅ Integration with Black, Ruff, isort, Flake8137- ✅ Docker-based test execution138- ✅ Comprehensive error handling and auto-fix139140**Try it now:** `/schema-generate event TestEvent "test with id and timestamp"`141142## 📦 Installation143144### Option A: Docker (Recommended)145```bash146# Production stable147docker pull aywengo/kafka-schema-reg-mcp:stable148149# Latest development150docker pull aywengo/kafka-schema-reg-mcp:latest151152# Specific version153docker pull aywengo/kafka-schema-reg-mcp:2.1.3154```155156#### Running with SLIM_MODE157To reduce LLM overhead, run with SLIM_MODE enabled:158```bash159# Run with a reduced essential tool set160docker run -e SCHEMA_REGISTRY_URL=http://localhost:8081 -e SLIM_MODE=true aywengo/kafka-schema-reg-mcp:stable161```162163> **💡 SLIM_MODE Benefits:**164> - Reduces tool count to an essential subset165> - Significantly faster LLM response times166> - Lower token usage and reduced costs167> - Ideal for production read-only operations168> - Maintains full remote deployment support169170### Option B: Local Python171```bash172git clone https://github.com/aywengo/kafka-schema-reg-mcp173cd kafka-schema-reg-mcp174pip install -r requirements.txt175python kafka_schema_registry_unified_mcp.py176```177178### Option C: Docker Compose179```bash180docker-compose up -d # Includes Schema Registry for testing181```182183> **📖 Detailed installation guide**: [docs/deployment.md](docs/deployment.md)184185## ⚙️ Configuration186187### Single Registry Mode188```bash189export SCHEMA_REGISTRY_URL="http://localhost:8081"190export SCHEMA_REGISTRY_USER="" # Optional191export SCHEMA_REGISTRY_PASSWORD="" # Optional192export VIEWONLY="false" # Production safety193export SLIM_MODE="false" # Optional: Enable to reduce tool overhead (default: false)194```195196### Multi-Registry Mode (Up to 8 Registries)197```bash198# Development Registry199export SCHEMA_REGISTRY_NAME_1="development"200export SCHEMA_REGISTRY_URL_1="http://dev-registry:8081"201export VIEWONLY_1="false"202203# Production Registry (with safety)204export SCHEMA_REGISTRY_NAME_2="production"205export SCHEMA_REGISTRY_URL_2="http://prod-registry:8081"206export VIEWONLY_2="true" # Read-only protection207```208209### Claude Desktop Configuration210Pre-configured examples available in [`config-examples/`](config-examples/):211212| Configuration | Use Case | File |213|---------------|----------|------|214| **Production** | Stable Docker deployment | [`claude_desktop_stable_config.json`](config-examples/claude_desktop_stable_config.json) |215| **Multi-Environment** | DEV/STAGING/PROD registries | [`claude_desktop_multi_registry_docker.json`](config-examples/claude_desktop_multi_registry_docker.json) |216| **Local Development** | Python local execution | [`claude_desktop_config.json`](config-examples/claude_desktop_config.json) |217| **View-Only Safety** | Production with safety | [`claude_desktop_viewonly_config.json`](config-examples/claude_desktop_viewonly_config.json) |218219> **📖 Complete configuration guide**: [config-examples/README.md](config-examples/README.md)220221### SLIM_MODE Configuration (Performance Optimization)222223**SLIM_MODE** reduces the number of exposed MCP tools to an essential subset, significantly reducing LLM overhead and improving response times.224225> **💡 Recommendation:** SLIM_MODE is **recommended for most use cases** as it provides all essential schema management capabilities with optimal performance.226227#### When to Use SLIM_MODE (Recommended)228- **Default choice** for most users and day-to-day operations229- When experiencing slow LLM responses due to too many tools230- For production environments focused on read-only operations231- When you only need basic schema management capabilities232- To reduce token usage and improve performance233234#### When to Use Non-SLIM Mode235- **For administrators or SRE teams** performing long-running operations236- When you need advanced operations like:237 - Schema migrations across registries238 - Bulk schema removals and cleanup operations239 - Complex batch operations and workflows240 - Interactive guided wizards for complex tasks241 - Comprehensive export/import operations242243#### Enable SLIM_MODE244```bash245export SLIM_MODE="true" # Reduces tools from 50+ to ~9246# Enables reduced essential tool set247```248249#### Tools Available in SLIM_MODE250**Essential Read-Only Tools:**251- `ping` - Server health check252- `set_default_registry`, `get_default_registry` - Registry management253- `count_contexts`, `count_schemas`, `count_schema_versions` - Statistics254255**Basic Write Operations:**256- `register_schema` - Register new schemas257- `check_compatibility` - Schema compatibility checking258- `create_context` - Create new contexts259260**Essential Export Operations:**261- `export_schema` - Export single schema262- `export_subject` - Export all subject versions263264**Resources Available (All Modes):**265- All 19 resources remain available in SLIM_MODE266- `registry://`, `schema://`, `subject://` resource URIs267- Full read access through resource-first approach268269**Tools Hidden in SLIM_MODE:**270- All migration tools (`migrate_schema`, `migrate_context`)271- All batch operations (`clear_context_batch`)272- Advanced export/import tools (`export_context`, `export_global`)273- All interactive/elicitation tools (`*_interactive` variants)274- Heavy statistics tools with async operations275- Workflow tools276- Configuration update tools277- Delete operations278279> **Note:** Task status tracking is now handled by FastMCP's built-in Docket system. Custom task management tools have been removed in favor of FastMCP's native task tracking.280281> **Note:** You can switch between modes by restarting with `SLIM_MODE=false` to access the full tool set.282283## 📊 MCP Tools and Resources284285This section provides a comprehensive analysis of all MCP tools and resources exposed by the Kafka Schema Registry MCP Server.286287### Backward Compatibility Wrapper Tools288These 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.289290| **Tool Name** | **SLIM_MODE** | **Scope** | **Recommended Resource** | **Description** |291|---------------|---------------|-----------|--------------------------|-----------------|292| `list_registries` | ✅ | read | `registry://names` | List all configured registries |293| `get_registry_info` | ✅ | read | `registry://info/{name}` | Get registry information |294| `test_registry_connection` | ✅ | read | `registry://status/{name}` | Test registry connection |295| `test_all_registries` | ✅ | read | `registry://status` | Test all registry connections |296| `list_subjects` | ✅ | read | `registry://{name}/subjects` | List all subjects |297| `get_schema` | ✅ | read | `schema://{name}/{context}/{subject}` | Get schema content |298| `get_schema_versions` | ✅ | read | `schema://{name}/{context}/{subject}/versions` | Get schema versions |299| `get_global_config` | ✅ | read | `registry://{name}/config` | Get global configuration |300| `get_mode` | ✅ | read | `registry://mode` | Get registry mode |301| `list_contexts` | ✅ | read | `registry://{name}/contexts` | List all contexts |302| `get_subject_config` | ✅ | read | `subject://{name}/{context}/{subject}/config` | Get subject configuration |303| `get_subject_mode` | ✅ | read | `subject://{name}/{context}/{subject}/mode` | Get subject mode |304305### Core MCP Tools306307| **Category** | **Name** | **Type** | **SLIM_MODE** | **Scope** | **Description** |308|--------------|----------|----------|---------------|-----------|-----------------|309| **Core** | `ping` | Tool | ✅ | read | MCP ping/pong health check |310| **Registry Management** | `set_default_registry` | Tool | ✅ | admin | Set default registry |311| **Registry Management** | `get_default_registry` | Tool | ✅ | read | Get current default registry |312| **Schema Operations** | `register_schema` | Tool | ✅ | write | Register new schema version |313| **Schema Operations** | `check_compatibility` | Tool | ✅ | read | Check schema compatibility |314| **Context Management** | `create_context` | Tool | ✅ | write | Create new context |315| **Context Management** | `delete_context` | Tool | ❌ | admin | Delete context |316| **Subject Management** | `delete_subject` | Tool | ❌ | admin | Delete subject and versions |317| **Configuration** | `update_global_config` | Tool | ❌ | admin | Update global configuration |318| **Configuration** | `update_subject_config` | Tool | ❌ | admin | Update subject configuration |319| **Configuration** | `add_subject_alias` | Tool | ❌ | write | Create alias subject pointing to an existing subject |320| **Configuration** | `delete_subject_alias` | Tool | ❌ | write | Remove an alias subject |321| **Mode Management** | `update_mode` | Tool | ❌ | admin | Update registry mode |322| **Mode Management** | `update_subject_mode` | Tool | ❌ | admin | Update subject mode |323| **Statistics** | `count_contexts` | Tool | ✅ | read | Count contexts |324| **Statistics** | `count_schemas` | Tool | ✅ | read | Count schemas |325| **Statistics** | `count_schema_versions` | Tool | ✅ | read | Count schema versions |326| **Statistics** | `get_registry_statistics` | Tool | ❌ | read | Get comprehensive registry stats |327| **Export** | `export_schema` | Tool | ✅ | read | Export single schema |328| **Export** | `export_subject` | Tool | ✅ | read | Export all subject versions |329| **Export** | `export_context` | Tool | ❌ | read | Export all context subjects |330| **Export** | `export_global` | Tool | ❌ | read | Export all contexts/schemas |331| **Export** | `export_global_interactive` | Tool | ❌ | read | Interactive global export |332| **Migration** | `migrate_schema` | Tool | ❌ | admin | Migrate schema between registries |333| **Migration** | `migrate_context` | Tool | ❌ | admin | Migrate context between registries |334| **Migration** | `migrate_context_interactive` | Tool | ❌ | admin | Interactive context migration |335| **Comparison** | `compare_registries` | Tool | ❌ | read | Compare two registries |336| **Comparison** | `compare_contexts_across_registries` | Tool | ❌ | read | Compare contexts across registries |337| **Comparison** | `find_missing_schemas` | Tool | ❌ | read | Find missing schemas |338| **Batch Operations** | `clear_context_batch` | Tool | ❌ | admin | Clear context with batch operations |339| **Batch Operations** | `clear_multiple_contexts_batch` | Tool | ❌ | admin | Clear multiple contexts |340| **Interactive** | `register_schema_interactive` | Tool | ❌ | write | Interactive schema registration |341| **Interactive** | `check_compatibility_interactive` | Tool | ❌ | read | Interactive compatibility check |342| **Interactive** | `create_context_interactive` | Tool | ❌ | write | Interactive context creation |343| **Resource Discovery** | `list_available_resources` | Tool | ✅ | read | List all available resources |344| **Resource Discovery** | `suggest_resource_for_tool` | Tool | ✅ | read | Get resource migration suggestions |345| **Resource Discovery** | `generate_resource_templates` | Tool | ✅ | read | Generate resource URI templates |346| **Elicitation** | `submit_elicitation_response` | Tool | ❌ | write | Submit elicitation response |347| **Elicitation** | `list_elicitation_requests` | Tool | ❌ | read | List elicitation requests |348| **Elicitation** | `get_elicitation_request` | Tool | ❌ | read | Get elicitation request details |349| **Elicitation** | `cancel_elicitation_request` | Tool | ❌ | admin | Cancel elicitation request |350| **Elicitation** | `get_elicitation_status` | Tool | ❌ | read | Get elicitation system status |351| **Workflows** | `list_available_workflows` | Tool | ❌ | read | List available workflows |352| **Workflows** | `get_workflow_status` | Tool | ❌ | read | Get workflow status |353| **Workflows** | `guided_schema_migration` | Tool | ❌ | admin | Start schema migration wizard |354| **Workflows** | `guided_context_reorganization` | Tool | ❌ | admin | Start context reorganization wizard |355| **Workflows** | `guided_disaster_recovery` | Tool | ❌ | admin | Start disaster recovery wizard |356| **Utility** | `get_mcp_compliance_status_tool` | Tool | ❌ | read | Get MCP compliance status |357| **Utility** | `get_oauth_scopes_info_tool` | Tool | ❌ | read | Get OAuth scopes information |358| **Utility** | `test_oauth_discovery_endpoints` | Tool | ❌ | read | Test OAuth discovery endpoints |359| **Utility** | `get_operation_info_tool` | Tool | ❌ | read | Get operation metadata |360| **Utility** | `check_viewonly_mode` | Tool | ❌ | read | Check if registry is in viewonly mode |361| **RESOURCES** | `registry://status` | Resource | ✅ | read | Overall registry connection status |362| **RESOURCES** | `registry://info` | Resource | ✅ | read | Detailed server configuration |363| **RESOURCES** | `registry://mode` | Resource | ✅ | read | Registry mode detection |364| **RESOURCES** | `registry://names` | Resource | ✅ | read | List of configured registry names |365| **RESOURCES** | `registry://status/{name}` | Resource | ✅ | read | Specific registry connection status |366| **RESOURCES** | `registry://info/{name}` | Resource | ✅ | read | Specific registry configuration |367| **RESOURCES** | `registry://mode/{name}` | Resource | ✅ | read | Specific registry mode |368| **RESOURCES** | `registry://{name}/subjects` | Resource | ✅ | read | List subjects for registry |369| **RESOURCES** | `registry://{name}/contexts` | Resource | ✅ | read | List contexts for registry |370| **RESOURCES** | `registry://{name}/config` | Resource | ✅ | read | Global config for registry |371| **RESOURCES** | `schema://{name}/{context}/{subject}` | Resource | ✅ | read | Schema content with context |372| **RESOURCES** | `schema://{name}/{subject}` | Resource | ✅ | read | Schema content default context |373| **RESOURCES** | `schema://{name}/{context}/{subject}/versions` | Resource | ✅ | read | Schema versions with context |374| **RESOURCES** | `schema://{name}/{subject}/versions` | Resource | ✅ | read | Schema versions default context |375| **RESOURCES** | `subject://{name}/{context}/{subject}/config` | Resource | ✅ | read | Subject config with context |376| **RESOURCES** | `subject://{name}/{subject}/config` | Resource | ✅ | read | Subject config default context |377| **RESOURCES** | `subject://{name}/{context}/{subject}/mode` | Resource | ✅ | read | Subject mode with context |378| **RESOURCES** | `subject://{name}/{subject}/mode` | Resource | ✅ | read | Subject mode default context |379| **RESOURCES** | `elicitation://response/{request_id}` | Resource | ❌ | write | Elicitation response handling |380381## 💬 Usage Examples382383### Schema Management384```bash385# In Claude Desktop, use natural language:386"Register a user schema with id, name, email fields"387"Check if my updated schema is compatible"388"Export all schemas from staging context"389"List subjects in production context"390```391392### Multi-Registry Operations393```bash394"Compare development and production registries"395"Migrate user-events schema from staging to production"396"Test connections to all registries"397"Show me registry statistics"398```399400### Batch Operations401```bash402"Clear all schemas from test context"403"Export global schemas for backup"404"Count schemas across all contexts"405```406407> **📖 More examples**: [examples/](examples/) | **📖 Use cases**: [docs/use-cases.md](docs/use-cases.md)408409## 🔒 Authentication & Security410411### OAuth 2.1 Support (Optional)412```bash413# Enable authentication414export ENABLE_AUTH=true415export AUTH_ISSUER_URL="https://your-oauth-provider.com"416export AUTH_AUDIENCE="your-client-id"417```418419**Supported Providers:** Azure AD, Google OAuth, Keycloak, Okta, GitHub420421**Permission Scopes:**422- `read` - View schemas, configurations423- `write` - Register schemas, update configs (includes read)424- `admin` - Delete subjects, full control (includes write + read)425426### Production Safety Features427- **VIEWONLY Mode** - Prevent accidental changes in production428- **URL Validation** - SSRF protection with configurable localhost access429- **Scope-based Authorization** - Fine-grained tool-level permissions430- **Per-Registry Controls** - Independent safety settings431432> **📖 Security guide**: [docs/deployment.md#security](docs/deployment.md#security)433434## 📚 Documentation435436| Guide | Description |437|-------|-------------|438| **[API Reference](docs/api-reference.md)** | Complete tool documentation with examples |439| **[Subject Aliasing](docs/subject-alias.md)** | How to add and remove subject aliases |440| **[Use Cases](docs/use-cases.md)** | Real-world scenarios and implementation patterns |441| **[Deployment Guide](docs/deployment.md)** | Docker, Kubernetes, cloud platforms, CI/CD |442| **[IDE Integration](docs/ide-integration.md)** | VS Code, Claude Code, Cursor setup |443| **[Configuration Examples](config-examples/)** | Ready-to-use Claude Desktop configs |444| **[Testing Guide](TESTING_SETUP_GUIDE.md)** | Comprehensive testing setup |445| **[Changelog](CHANGELOG.md)** | Version history and migration notes |446| **[v2.0.0 Highlights](README-v2.0.0-HIGHLIGHTS.md)** | Major version features |447448### Additional Resources449- **[Examples](examples/)** - Usage examples and code samples450- **[Scripts](scripts/)** - Utility scripts and automation451- **[Helm Charts](helm/)** - Kubernetes deployment452- **[Tests](tests/)** - Test suites and validation453454## 🧪 Testing455456### Quick Test457```bash458cd tests/459./run_all_tests.sh --quick # Essential tests460./run_all_tests.sh # Complete test suite461```462463### Docker Testing464```bash465python tests/test_docker_mcp.py466```467468### MCP Inspector Tests (UI-driven)469```bash470# From repository root471cd inspector-tests472473# Single registry (DEV)474./run-inspector-tests.sh stable475476# Multi-registry (DEV + PROD)477./run-inspector-tests.sh multi478479# Test a specific Docker tag480DOCKER_VERSION=latest ./run-inspector-tests.sh stable481```482483> **📖 Testing guide**: [TESTING_SETUP_GUIDE.md](TESTING_SETUP_GUIDE.md)484485## 🚀 Deployment486487### Production Docker488```bash489# With docker-compose490docker-compose up -d491492# Direct Docker493docker run -d -p 38000:8000 \494 -e SCHEMA_REGISTRY_URL=http://registry:8081 \495 aywengo/kafka-schema-reg-mcp:stable496```497498### Kubernetes499```bash500# Using Helm charts501helm install kafka-schema-mcp ./helm/kafka-schema-reg-mcp502```503504> **📖 Deployment guide**: [docs/deployment.md](docs/deployment.md)505506## 🤝 Contributing507508We welcome contributions! Please see:509- **[Contributing Guidelines](.github/CONTRIBUTING.md)**510- **[Code of Conduct](.github/CODE_OF_CONDUCT.md)**511- **[Development Setup](docs/deployment.md#local-development)**512513### Quick Development Setup514```bash515git clone https://github.com/aywengo/kafka-schema-reg-mcp516cd kafka-schema-reg-mcp517python -m venv .venv && source .venv/bin/activate518pip install -r requirements.txt519python kafka_schema_registry_unified_mcp.py520```521522## 🆕 What's New523524### v2.1.x (Latest)525- **🧭 Subject Aliasing** - New tools `add_subject_alias` and `delete_subject_alias`526- **🛠️ Fixes** - Evolution assistant and import interactive fixes527- **📦 Enhancements** - Continued MCP tool refinements and testing improvements528- **🗑️ Removed Deprecated Tools** - Custom task management tools removed in favor of FastMCP's built-in Docket system529530### v2.0.x531- **🔒 Security Fixes** - Resolved credential exposure in logging532- **🤖 Interactive Schema Migration** - Smart migration with user preference elicitation533- **💾 Automatic Backups** - Pre-migration backup creation534- **✅ Post-Migration Verification** - Comprehensive schema validation535- **🚀 FastMCP 2.8.0+ Framework** - Complete architecture upgrade536- **📊 MCP 2025-06-18 Compliance** - Latest protocol specification537- **🔐 OAuth 2.1 Generic Discovery** - Universal provider compatibility538- **🔗 Resource Linking** - HATEOAS navigation in tool responses539540> **📖 Full changelog**: [CHANGELOG.md](CHANGELOG.md) | **📖 v2.0.0 features**: [README-v2.0.0-HIGHLIGHTS.md](README-v2.0.0-HIGHLIGHTS.md)541542---543**🐳 Glama.ai:**544545<a href="https://glama.ai/mcp/servers/@aywengo/kafka-schema-reg-mcp">546 <img width="380" height="200" src="https://glama.ai/mcp/servers/@aywengo/kafka-schema-reg-mcp/badge" />547</a>548549---550551**🐳 Docker Hub:** [`aywengo/kafka-schema-reg-mcp`](https://hub.docker.com/r/aywengo/kafka-schema-reg-mcp) | **📊 Stats:** 50+ MCP Tools (12 backward compatibility), 19 Resources, 8 Registries, OAuth 2.1, Multi-platform552553**License:** MIT | **Maintainer:** [@aywengo](https://github.com/aywengo) | **Issues:** [GitHub Issues](https://github.com/aywengo/kafka-schema-reg-mcp/issues)554
Full transparency — inspect the skill content before installing.