aywengo/kafka-schema-reg-mcp

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.
> **🎯 True MCP Implementation**: Uses **FastMCP 3.2.0+** (3.x, capped below 4) with **MCP 2025-11-25** specification compliance. Fully compatible with Claude Desktop and other MCP clients using JSON-RPC over stdio.
**Latest Version:** v2.2.2 | **Docker:** aywengo/kafka-schema-reg-mcp:stable
📋 Table of Contents
- 🚀 Quick Start
- ✨ Key Features
- 🛠️ Claude Code Skills
- 📦 Installation
- ⚙️ Configuration
- 💬 Usage Examples
- 🔒 Authentication & Security
- 📚 Documentation
- 🧪 Testing
- 🚀 Deployment
- 🤝 Contributing
- 🆕 What's New
🚀 Quick Start
1. Run with Docker (Recommended)
2. Configure Claude Desktop
Copy a ready-to-use configuration from config-examples/:
3. Start Using with Claude
Restart Claude Desktop and try these prompts:
- *"List all schema contexts"*
- *"Show me the subjects in the production context"*
- *"Register a new user schema with fields for id, name, and email"*
✨ 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-11-25 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-evolve** - Safely evolve schemas with automatic compatibility checking
- **/migration-plan** - Create detailed migration plans between environments
- **/lint-and-test** - Automated quality assurance workflows
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"
📦 Installation
Option A: Docker (Recommended)
Running with SLIM_MODE
To reduce LLM overhead, run with SLIM_MODE enabled:
> **💡 SLIM_MODE Benefits:**
> - Reduces tool count to an essential subset
> - Significantly faster LLM response times
> - Lower token usage and reduced costs
> - Ideal for production read-only operations
> - Maintains full remote deployment support
Option B: Local Python
Option C: Docker Compose
> **📖 Detailed installation guide**: docs/deployment.md
⚙️ Configuration
Single Registry Mode
Multi-Registry Mode (Up to 8 Registries)
Claude Desktop Configuration
Pre-configured examples available in config-examples/:
| Configuration | Use Case | File |
|---------------|----------|------|
| **Production** | Stable Docker deployment | claude_desktop_stable_config.json |
| **Multi-Environment** | DEV/STAGING/PROD registries | claude_desktop_multi_registry_docker.json |
| **Local Development** | Python local execution | claude_desktop_config.json |