Databricks MCP Server by CData

Servidor Databricks-MCP por cdata

Servidor de protocolo de contexto de modelo (MCP) de CData para Databricks

:heavy_exclamation_mark: Este proyecto crea un servidor MCP de solo lectura. Para disfrutar de funciones completas de lectura, escritura, actualización, eliminación y acción, y una configuración simplificada, consulte nuestro servidor CData MCP gratuito para Databricks (beta) .

Objetivo

Creamos este servidor MCP de solo lectura para permitir que los LLM (como Claude Desktop) consulten datos en vivo de Databricks compatibles con el controlador JDBC de CData para Databricks .

El controlador JDBC de CData se conecta a Databricks exponiéndolos como modelos SQL relacionales.

Este servidor envuelve ese controlador y hace que los datos de Databricks estén disponibles a través de una interfaz MCP simple, de modo que los LLM puedan recuperar información en vivo haciendo preguntas en lenguaje natural, sin necesidad de SQL.

Guía de configuración

1. Clonar el repositorio:
   git clone https://github.com/cdatasoftware/databricks-mcp-server-by-cdata.git cd databricks-mcp-server-by-cdata
2. Construir el servidor:
   mvn clean install
   Esto crea el archivo JAR: CDataMCP-jar-with-dependencies.jar
3. Descargue e instale el controlador JDBC de CData para {source}: https://www.cdata.com/drivers/databricks/download/jdbc
4. Licencia del controlador JDBC de CData:
   • Navegue a la carpeta lib en el directorio de instalación, normalmente:
     • (Windows) C:\Program Files\CData\CData JDBC Driver for Databricks\
     • (Mac/Linux) /Applications/CData JDBC Driver for Databricks/
   • Ejecute el comando java -jar cdata.jdbc.databricks.jar --license
   • Ingrese su nombre, correo electrónico y "TRIAL" (o su clave de licencia).
5. Configure su conexión a la fuente de datos (Salesforce como ejemplo):
   • Ejecute el comando java -jar cdata.jdbc.databricks.jar para abrir la utilidad de cadena de conexión.
   • Configure la cadena de conexión y haga clic en "Probar conexión"

     Nota: Si las fuentes de datos utilizan OAuth, deberá autenticarse en su navegador.

   • Una vez realizado el proceso, copie la cadena de conexión para usarla más tarde.
6. Cree un archivo .prp para su conexión JDBC (por ejemplo, databricks.prp ) utilizando las siguientes propiedades y formato:
   • Prefijo : un prefijo que se utilizará para las herramientas expuestas
   • ServerName : un nombre para su servidor
   • ServerVersion : una versión para su servidor
   • DriverPath : la ruta completa al archivo JAR para su controlador JDBC
   • DriverClass : el nombre de la clase del controlador JDBC (por ejemplo, cdata.jdbc.databricks.DatabricksDriver)
   • JdbcUrl : la cadena de conexión JDBC que se utilizará con el controlador JDBC CData para conectarse a sus datos (copiada de arriba)
   • Tablas : déjelo en blanco para acceder a todos los datos; de lo contrario, puede declarar explícitamente las tablas para las que desea crear acceso.
     Prefix=databricks ServerName=CDataDatabricks ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.databricks.jar DriverClass=cdata.jdbc.databricks.DatabricksDriver JdbcUrl=jdbc:databricks:InitiateOAuth=GETANDREFRESH; Tables=

Usando el servidor con Claude Desktop

1. Cree el archivo de configuración de Claude Desktop (claude_desktop_config.json) para agregar el nuevo servidor MCP, usando el formato a continuación. Si el archivo ya existe, agregue la entrada a mcpServers en el archivo de configuración.Ventanas
   { "mcpServers": { "{classname_dash}": { "command": "PATH\\TO\\java.exe", "args": [ "-jar", "PATH\\TO\\CDataMCP-jar-with-dependencies.jar", "PATH\\TO\\databricks.prp" ] }, ... } }
   Linux/Mac
   { "mcpServers": { "{classname_dash}": { "command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/databricks.prp" ] }, ... } }
   Si es necesario, copie el archivo de configuración al directorio apropiado (Claude Desktop como ejemplo). Windows
   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
   Linux/Mac
   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'
2. Ejecute o actualice su cliente (Claude Desktop).

Nota: Es posible que tengas que salir por completo o cerrar tu cliente de Claude Desktop y volver a abrirlo para que aparezcan los servidores MCP.

Ejecución del servidor

1. Ejecute el siguiente comando para ejecutar el servidor MCP por sí solo
   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Nota: El servidor utiliza stdio por lo que solo se puede utilizar con clientes que se ejecuten en la misma máquina que el servidor.

Detalles de uso

Una vez configurado el servidor MCP, el cliente de IA podrá usar las herramientas integradas para leer, escribir, actualizar y eliminar los datos subyacentes. Generalmente, no es necesario llamar a las herramientas explícitamente. Simplemente pídale al cliente que responda preguntas sobre el sistema de datos subyacente. Por ejemplo:

• "¿Cuál es la correlación entre mis oportunidades cerradas y la industria de la cuenta?"
• "¿Cuántos tickets abiertos tengo en el proyecto SUPPORT?"
• "¿Puedes decirme qué eventos del calendario tengo hoy?"

A continuación se muestra la lista de herramientas disponibles y sus descripciones:

Herramientas y descripciones

En las definiciones a continuación, {servername} hace referencia al nombre del servidor MCP en el archivo de configuración (por ejemplo {classname_dash} arriba).

• {servername}_get_tables : Obtiene una lista de las tablas disponibles en la fuente de datos. Utilice la herramienta {servername}_get_columns para listar las columnas disponibles en una tabla. La salida de la herramienta se devolverá en formato CSV, con la primera línea con los encabezados de columna.
• {servername}_get_columns : Obtiene una lista de columnas para una tabla. Utilice la herramienta {servername}_get_tables para obtener una lista de las tablas disponibles. La salida de la herramienta se devolverá en formato CSV, con la primera línea con los encabezados de columna.
• {servername}_run_query - Ejecutar una consulta SELECT de SQL

Solución de problemas

1. Si no puede ver su servidor CData MCP en Claude Desktop, asegúrese de haber salido completamente de Claude Desktop (Windows: use el Administrador de tareas, Mac: use el Monitor de actividad)
2. Si Claude Desktop no puede recuperar datos, asegúrese de haber configurado correctamente su conexión. Utilice el generador de cadenas de conexión para crear la cadena de conexión (ver arriba) y cópiela en el archivo de propiedades (.prp).
3. Si tiene problemas para conectarse a su fuente de datos, comuníquese con el equipo de soporte de CData .
4. Si tiene problemas al utilizar el servidor MCP o tiene algún otro comentario, únase a la Comunidad CData .

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.

Todas las fuentes compatibles