用途
kafka-schema-reg-mcp 是一个综合性的 Model Context Protocol（MCP）服务器，用于 Kafka Schema Registry 操作。它让 Claude Desktop 及其他 MCP 客户端能够通过自然语言界面直接管理 Schema Registry，包括 Schema 注册、兼容性检查、上下文管理、跨注册表迁移和导出等。
主要能力
- Claude Desktop 集成：通过 stdio 上的 JSON-RPC 与 Claude Desktop 等 MCP 客户端直接集成，提供自然语言交互界面。
- 多注册表支持：可同时管理最多 8 个 Schema Registry 实例。
- Schema 上下文：通过逻辑分组隔离生产/预发环境。
- Schema 迁移：支持跨注册表迁移，包含备份与验证。
- 全面导出：支持 JSON、Avro IDL 格式，用于备份和文档化。
- 生产安全：提供 VIEWONLY 模式和按注册表的访问控制。
- OAuth 2.1 认证：企业级安全，支持基于作用域的权限（read、write、admin）。
- 实时进度：异步操作支持进度跟踪与取消。
- 资源链接：工具响应中提供 HATEOAS 导航。
- 完整 MCP 合规：50+ 工具，遵循 MCP 2025-11-25 规范。
- SLIM_MODE：将工具数量从 50+ 减少到约 9 个核心工具，提升 LLM 性能。
Claude Code 技能
项目包含 5 个专用 Claude Code 技能：
/schema-generate：从自然语言生成生产级 Avro Schema。/schema-evolve：安全演进 Schema，自动兼容性检查。/migration-plan：创建环境间的详细迁移计划。/lint-and-test：自动化质量保证工作流。/context-compare：Schema 上下文比较。
使用方式
安装与运行
推荐使用 Docker：
docker run aywengo/kafka-schema-reg-mcp:stable
也可使用本地 Python 或 Docker Compose。详细安装指南见 docs/deployment.md。
配置 Claude Desktop
从 config-examples/ 复制现成配置，支持单注册表模式和多注册表模式（最多 8 个）。
使用示例
重启 Claude Desktop 后，可尝试以下提示：
- "List all schema contexts"
- "Show me the subjects in the production context"
- "Register a new user schema with fields for id, name, and email"
SLIM_MODE
通过设置 SLIM_MODE=true 启用，减少暴露的 MCP 工具数量，降低 LLM 开销，加快响应速度，适合大多数日常操作和只读生产环境。所有 19 个资源在 SLIM_MODE 下仍可用。
适用场景
- 使用 Claude Desktop 管理 Kafka Schema Registry 的开发者。
- 需要跨多个注册表进行 Schema 迁移和同步的团队。
- 需要生产环境只读安全访问的运维/SRE 团队。
- 需要自动化 Schema 生成、演进和兼容性检查的工作流。
限制
- 多注册表支持上限为 8 个实例。
- SLIM_MODE 下隐藏迁移、批量操作、高级导出/导入、交互式工具等。
- OAuth 2.1 为可选功能，需配置支持的提供商（Azure AD、Google OAuth、Keycloak、Okta、GitHub）。
- 自定义任务管理工具已移除，任务状态跟踪由 FastMCP 内置 Docket 系统处理。
- 具体收费、价格、平台兼容性等未在资料中提供。
