Skip to content

feat(binding-mcp-schema-registry): implement mcp_schema_registry proxy binding#1716

Open
jfallows wants to merge 5 commits into
developfrom
feature/1672-mcp-schema-registry
Open

feat(binding-mcp-schema-registry): implement mcp_schema_registry proxy binding#1716
jfallows wants to merge 5 commits into
developfrom
feature/1672-mcp-schema-registry

Conversation

@jfallows
Copy link
Copy Markdown
Contributor

@jfallows jfallows commented Apr 7, 2026

Summary

  • Adds runtime/binding-mcp-schema-registry/ module implementing the mcp_schema_registry · proxy binding (issue binding-mcp-schema-registry: implement mcp_schema_registry · proxy binding #1672)
  • Bundles a Confluent/Karapace Schema Registry OpenAPI spec as a classpath resource (schema-registry-openapi.json)
  • Pre-maps 10 LLM-optimised tool names to Schema Registry operationIds: list_subjectslist, describe_subjectgetSchemaVersions, get_schemagetSchemaByVersion, register_schemaregister, delete_subjectdeleteSubject, delete_schema_versiondeleteSchemaVersion, check_compatibilitytestCompatibilityBySubjectName_1, get_compatibilitygetSubjectLevelConfig, set_compatibilityupdateSubjectLevelConfig, list_contextsgetContexts
  • Adds specs/binding-mcp-schema-registry.spec/ with JSON schema patch for zilla.yaml validation (route when conditions accept enumerated tool names)
  • Registers module in runtime/pom.xml and specs/pom.xml

Architecture

  • McpSchemaRegistryBinding — binding name mcp_schema_registry, proxy kind
  • McpSchemaRegistryBindingContext — wires McpSchemaRegistryProxyFactory for PROXY kind
  • McpSchemaRegistryProxyFactoryBindingHandler with static TOOL_OPERATION_IDS map of all 10 tool→operationId mappings
  • McpSchemaRegistryConditionConfig(Adapter)when: [{tool: ...}] route conditions
  • McpSchemaRegistryOptionsConfigAdapter — no-op options (binding requires no custom options)
  • module-info.java — provides BindingFactorySpi, OptionsConfigAdapterSpi, ConditionConfigAdapterSpi

Test plan

  • Verify binding-mcp-schema-registry compiles: ./mvnw install -pl runtime/binding-mcp-schema-registry -am -DskipTests -DskipITs
  • Verify binding-mcp-schema-registry.spec compiles: ./mvnw install -pl specs/binding-mcp-schema-registry.spec -am -DskipTests -DskipITs
  • Confirm binding is discoverable via BindingFactorySpi service loader
  • Confirm zilla.yaml with type: mcp_schema_registry and kind: proxy validates without errors
  • Confirm all 10 tool names are in TOOL_OPERATION_IDS static map in McpSchemaRegistryProxyFactory

https://claude.ai/code/session_0174raBeXFTgt98bp4DTyRDm

claude added 5 commits April 7, 2026 05:29
Implements the foundational mcp binding module with server kind handler,
McpBeginEx IDL type, JSON schema patch, config adapters, and module-info.

Closes #1668

https://claude.ai/code/session_0174raBeXFTgt98bp4DTyRDm
Adds the mcp_openapi proxy binding that accepts MCP tool/resource streams
and routes them to OpenAPI-backed HTTP operations. Includes config adapters
for options.specs (catalog references), options.tools (per-tool descriptions),
routes.when (tool name / resource URI), and routes.with (api-id / operation-id).
Also adds stub modules for binding-mcp-http and binding-mcp-http.spec, and
adds pom.xml + mcp.idl to specs/binding-mcp.spec which were missing from the
prior binding-mcp commit.

https://claude.ai/code/session_0174raBeXFTgt98bp4DTyRDm
…y binding (#1672)

Adds mcp_schema_registry proxy binding that maps LLM-optimised tool names
to Confluent/Karapace Schema Registry operationIds. Includes bundled
OpenAPI spec for the Schema Registry REST API and JSON schema patch for
zilla.yaml validation.

https://claude.ai/code/session_0174raBeXFTgt98bp4DTyRDm
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants