Catálogo MCP

Servidor MCP independiente de solo lectura para explorar metadatos de objetos de negocio de Oracle HDL desde el repositorio local de ingesta de objetos de negocio.

El índice del catálogo trata attributes/*.json como la fuente de verdad. manifest.json es un metadato complementario opcional que solo se utiliza cuando coincide con un documento de atributo indexado.

Configuración local

1. Cree un entorno virtual con Python 3.10+.

2. Instale las dependencias.

3. Apunte CATALOG_MCP_DATA_ROOT al repositorio de ingesta de objetos de negocio si no desea la ruta hermana predeterminada.

'/Users/justin/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3' -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'
cp .env.example .env

Opcionalmente, puede limitar el servidor a uno o más objetos de negocio exactos:

CATALOG_MCP_ALLOWED_OBJECTS=Worker

o:

CATALOG_MCP_ALLOWED_OBJECTS=Worker,Location

Ejecutar el servidor

.venv/bin/python -m catalog_mcp.server

El servidor se ejecuta sobre stdio de forma predeterminada.

También puede utilizar el lanzador incluido, que establece CATALOG_MCP_DATA_ROOT de forma predeterminada en el repositorio de objetos de negocio hermano en este portátil:

./scripts/run_catalog_mcp.sh

Registrar con Codex

Añada el servidor a la configuración local de Codex MCP:

codex mcp add businessObjectCatalog -- /Users/justin/Documents/Codex/Projects/MCP/scripts/run_catalog_mcp.sh

Verifique el registro:

codex mcp list
codex mcp get businessObjectCatalog

Prueba

.venv/bin/pytest

Ejecute la matriz de presión de extremo a extremo:

.venv/bin/python scripts/pressure_test_catalog.py

Superficie pública de MCP

• Herramientas:

  • catalog_health

  • get_catalog_stats

  • list_catalog_entries

  • get_catalog_entry

  • get_catalog_component

  • get_catalog_attribute

  • search_catalog

  • search_catalog_attributes

  • get_related_entries

  • refresh_catalog_index

• Recursos:

  • catalog://summary

  • catalog://product-areas

  • catalog://stats

  • catalog://entries/{entry_id}

Recuperación de alcance exacto

Si un agente ya conoce el objeto, componente o campo, prefiera la recuperación exacta sobre la búsqueda amplia.

Ejemplos:

{"identifier":"Worker"}

{"identifier":"Worker","component_name":"Worker"}

{"identifier":"Worker","component_name":"Worker","attribute_name":"WorkerNumber"}