mcp-server-unitycatalog: Un servidor MCP de Unity Catalog

Descripción general

Servidor de Protocolo de Contexto de Modelo para el Catálogo de Unity . Este servidor proporciona funciones del Catálogo de Unity como herramientas MCP.

Herramientas

Puede utilizar todas las funciones de Unity Catalog registradas en Unity Catalog junto con las siguientes herramientas de IA predefinidas de Unity Catalog:

uc_list_functions
- Enumera las funciones dentro del catálogo y esquema principal especificados.
- Devuelve: una lista de funciones recuperadas del Catálogo de Unity.
uc_get_function
- Obtiene una función dentro de un catálogo y esquema padre.
- Aporte:
  - name (cadena): el nombre de la función (no completamente calificado).
- Devuelve: Detalles de una función recuperados del Catálogo de Unity.
uc_create_function
- Crea una función dentro de un catálogo y esquema principal. ADVERTENCIA: Esta API es experimental y cambiará en futuras versiones .
- Aporte:
  - name (cadena): el nombre de la función (no completamente calificado).
  - script (cadena): el script de Python que incluye la función que se registrará.
- Devuelve: Detalles de una función creada dentro del Catálogo de Unity.
uc_delete_function
- Elimina una función dentro de un catálogo y esquema principal.
- Aporte:
  - name (cadena): el nombre de la función (no completamente calificado).
- Devoluciones: Ninguna.

Instalación

Usando uv

Al usar uv no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-git .

Configuración

Estos valores también se pueden configurar mediante las opciones de la CLI o las variables de entorno .env . Los argumentos obligatorios son el servidor del Catálogo de Unity, el catálogo y el esquema, mientras que el token de acceso y el nivel de detalle son opcionales. Ejecute uv run mcp-server-unitycatalog --help para obtener opciones de configuración más detalladas.

Argumento	Variable de entorno	Descripción	Obligatorio/Opcional
`-u` , `--uc_server`	`UC_SERVER`	La URL base del servidor del catálogo de Unity.	Requerido
`-c` , `--uc_catalog`	`UC_CATALOG`	El nombre del catálogo de Unity Catalog.	Requerido
`-s` , `--uc_schema`	`UC_SCHEMA`	El nombre del esquema dentro de un catálogo de Unity Catalog.	Requerido
`-t` , `--uc_token`	`UC_TOKEN`	El token de acceso utilizado para autorizar solicitudes de API al servidor de Unity Catalog.	Opcional
`-v` , `--uc_verbosity`	`UC_VERBOSITY`	Nivel de detalle del registro. Valor predeterminado: `warn` .	Opcional
`-l` , `--uc_log_directory`	`UC_LOG_DIRECTORY`	Directorio donde se almacenarán los archivos de registro. Valor predeterminado: `.mcp_server_unitycatalog` .	Opcional

Uso con Claude Desktop o VSCode Cline

Agregue esto a su claude_desktop_config.json (o cline_mcp_settings.json ):

{
  "mcpServers": {
    "unitycatalog": {
      "command": "uv",
      "args": [
        "--directory",
        "/<path to your local git repository>/mcp-server-unitycatalog",
        "run",
        "mcp-server-unitycatalog",
        "--uc_server",
        "<your unity catalog url>",
        "--uc_catalog",
        "<your catalog name>",
        "--uc_schema",
        "<your schema name>"
      ]
    }
  }
}

Nota: reemplace '/Users/username' con la ruta a la que desea que esta herramienta pueda acceder

{
  "mcpServers": {
    "unitycatalog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/unitycatalog",
        "--uc_server",
        "<your unity catalog url>",
        "--uc_catalog",
        "<your catalog name>",
        "--uc_schema",
        "<your schema name>"
      ]
    }
  }
}

Edificio

Estibador:

docker build -t mcp/unitycatalog .   

Planes futuros

[x] Implementar soporte para list_functions .
[x] Implementar soporte para get_function .
[x] Implementar soporte para create_python_function .
[x] Implementar soporte para execute_function .
[x] Implementar soporte para delete_function .
[ ] Implementar herramientas de exploración de catálogo semántico.
[x] Agregar imagen de Docker.
[ ] Implementar los métodos use_xxx . En la implementación actual, catalog y schema deben definirse al iniciar el servidor. Sin embargo, se implementarán como funciones use_catalog y use_schema , actualizando dinámicamente la lista de funciones disponibles al ejecutar use_xxx .

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Integrations