Kafka Schema Registry MCP Server

Name: Kafka Schema Registry MCP Server
Author: aywengo

@aywengo

Repository

About Kafka Schema Registry MCP Server

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

#kafka #schema-registry #mcp #apache-kafka #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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_USER_1",
        "-e",
        "SCHEMA_REGISTRY_PASSWORD_1",
        "-e",
        "READONLY_1",
        "-e",
        "SCHEMA_REGISTRY_NAME_2",
        "-e",
        "SCHEMA_REGISTRY_URL_2",
        "-e",
        "SCHEMA_REGISTRY_USER_2",
        "-e",
        "SCHEMA_REGISTRY_PASSWORD_2",
        "-e",
        "READONLY_2",
        "aywengo/kafka-schema-reg-mcp:stable",
        "python",
        "kafka_schema_registry_unified_mcp.py"
      ],
      "env": {
        "SCHEMA_REGISTRY_NAME_1": "<NAME of SR 1>",
        "SCHEMA_REGISTRY_URL_1": "<URL of SR  1>",
        "SCHEMA_REGISTRY_USER_1": "",
        "SCHEMA_REGISTRY_PASSWORD_1": "",
        "READONLY_1": "false",
        "SCHEMA_REGISTRY_NAME_2": "<NAME of SR 2>",
        "SCHEMA_REGISTRY_URL_2": "<URL of SR 2>",
        "SCHEMA_REGISTRY_USER_2": "",
        "SCHEMA_REGISTRY_PASSWORD_2": "",
        "READONLY_2": "false"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Kafka Schema Registry MCP Server?

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

How to use Kafka Schema Registry MCP Server?

Install via Docker (recommended) with environment variables for registry URL, then configure Claude Desktop using the provided config examples. Interact using natural language prompts to list contexts, register schemas, or export schemas. Alternatively, run locally with Python or use Docker Compose for testing.

Key features of Kafka Schema Registry MCP Server

Multi-registry management (up to 8 registries)
Schema contexts for environment isolation
Schema migration with backup and verification
Comprehensive export in JSON and Avro IDL formats
Production safety with VIEWONLY mode
OAuth 2.1 authentication support

Use cases of Kafka Schema Registry MCP Server

Register new Avro schemas and check compatibility
Migrate schemas between development and production registries
Export schemas for backup and documentation
Manage multiple Schema Registry instances in one interface
Generate schemas from natural language using Claude Code skills

FAQ from Kafka Schema Registry MCP Server

What is SLIM_MODE?

SLIM_MODE reduces the number of exposed MCP tools to an essential subset (~9 tools) for faster LLM response times and lower token usage. It is recommended for most day-to-day operations.

Can I manage multiple Schema Registry instances?

Yes, the server supports up to 8 registries simultaneously using environment variables with numbered suffixes (e.g., SCHEMA_REGISTRY_NAME_1, SCHEMA_REGISTRY_URL_2). Each registry can have its own VIEWONLY and authentication settings.

How do I secure the server for production use?

Set VIEWONLY=true to enable read-only protection, and use OAuth 2.1 authentication with scope-based permissions via the SCHEMA_REGISTRY_USER and SCHEMA_REGISTRY_PASSWORD environment variables.

What transport and protocol does it use?

The server uses the MCP 2025-06-18 specification over stdio (JSON-RPC) for communication with Claude Desktop and other MCP clients.

What are the runtime requirements?

Python 3.10 or higher is required. The server depends on the FastMCP 2.8.0+ framework and Python libraries listed in requirements.txt. Docker images are available for deployment.