aywengo/kafka-schema-reg-mcp

Kafka Schema Registry MCP服务器镜像

这是一个全面的MCP（模型上下文协议）服务器，为Claude Desktop及其他MCP客户端提供Kafka Schema Registry操作工具，基于官方SDK实现JSON-RPC over stdio的标准MCP协议。

✨核心功能

• Claude Desktop兼容：通过MCP协议直接集成
• 48个MCP工具：支持自然语言驱动的完整Schema操作
• 多注册中心支持：可连接最多8个Schema Registry实例
• 异步操作：非阻塞任务与实时进度跟踪
• 上下文管理：通过"子注册中心"实现逻辑分组
• 简化迁移：提供一键运行的Docker迁移命令
• 生产就绪：支持单注册中心VIEWONLY模式与认证机制
• 多平台支持：适配AMD64和ARM64架构

🚀快速开始

拉取镜像

bash
# 稳定版（推荐）
docker pull docker.xuanyuan.run/aywengo/kafka-schema-reg-mcp:stable

# 开发版
docker pull docker.xuanyuan.run/aywengo/kafka-schema-reg-mcp:latest

SLIM_MODE优化性能

启用SLIM_MODE可减少LLM开销，仅保留约15个核心工具：

bash
docker run -i --rm --network host \
  -e SCHEMA_REGISTRY_URL=http://localhost:8081 \
  -e SLIM_MODE=true \
  docker.xuanyuan.run/aywengo/kafka-schema-reg-mcp:stable

💡 SLIM_MODE优势

• 工具数量从53+缩减至15个核心工具
• 显著提升LLM响应速度
• 降低token使用量与成本
• 适合生产环境只读操作
• 只需设置环境变量SLIM_MODE=true

单注册中心模式

bash
docker run -i --rm --network host \
  -e SCHEMA_REGISTRY_URL=http://localhost:8081 \
  docker.xuanyuan.run/aywengo/kafka-schema-reg-mcp:stable

多注册中心模式

bash
docker run -i --rm --network host \
  -e SCHEMA_REGISTRY_NAME_1=development \
  -e SCHEMA_REGISTRY_URL_1=http://dev-registry:8081 \
  -e SCHEMA_REGISTRY_NAME_2=production \
  -e SCHEMA_REGISTRY_URL_2=http://prod-registry:8081 \
  -e VIEWONLY_2=true \
  docker.xuanyuan.run/aywengo/kafka-schema-reg-mcp:stable

🤖 Claude Desktop集成

添加到Claude Desktop配置文件（macOS路径：~/Library/Application Support/Claude/claude_desktop_config.json）：

单注册中心配置

json
{
  "mcpServers": {
    "kafka-schema-registry": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network", "host",
        "-e", "SCHEMA_REGISTRY_URL",
        "aywengo/kafka-schema-reg-mcp:stable"
      ],
      "env": {
        "SCHEMA_REGISTRY_URL": "http://localhost:8081"
      }
    }
  }
}

多注册中心配置

json
{
  "mcpServers": {
    "kafka-schema-registry-multi": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network", "host",
        "-e", "SCHEMA_REGISTRY_NAME_1", "-e", "SCHEMA_REGISTRY_URL_1",
        "-e", "SCHEMA_REGISTRY_NAME_2", "-e", "SCHEMA_REGISTRY_URL_2", "-e", "VIEWONLY_2",
        "aywengo/kafka-schema-reg-mcp:stable"
      ],
      "env": {
        "SCHEMA_REGISTRY_NAME_1": "development",
        "SCHEMA_REGISTRY_URL_1": "http://localhost:8081",
        "SCHEMA_REGISTRY_NAME_2": "production", 
        "SCHEMA_REGISTRY_URL_2": "http://localhost:8082",
        "VIEWONLY_2": "true"
      }
    }
  }
}

🗣️自然语言使用示例

在Claude Desktop中可使用以下自然语言命令：

• "列出所有Schema上下文"
• "注册包含id、name和email字段的用户Schema"
• "将 staging 上下文迁移到 production"
• "对比开发与生产注册中心"
• "导出生产上下文的所有Schema"
• "检查更新后的Schema是否兼容"

🔧配置说明

环境变量

VIEWONLY模式

设置VIEWONLY=true可保障生产环境安全：

• ✅ 允许操作：Schema浏览、兼容性检查、导出
• ❌ 禁止操作：Schema注册、删除、配置修改

🚀上下文迁移

migrate_context工具会生成可直接运行的Docker命令（基于外部工具https://github.com/aywengo/kafka-schema-reg-migrator）：

"将staging上下文迁移到production"
→ 返回：自动映射凭证的Docker运行命令  
→ 特点：可直接复制粘贴执行，无需文件配置  

📚相关链接

• GitHub仓库：https://github.com/aywengo/kafka-schema-reg-mcp
• 文档：仓库内包含完整指南与API参考
• 许可证：MIT License

立即开始：拉取镜像并配置Claude Desktop，用自然语言管理你的Kafka Schema Registry！🚀