azure-data-catalog-mcp-server-by-cdata

Servidor Model Context Protocol (MCP) de CData per a Azure Data Catalog

:heavy_exclamation_mark: Aquest projecte construeix un servidor MCP només de lectura. Per a capacitats completes de lectura, escriptura, actualització, esborrat i acció, i una configuració simplificada, consulteu el nostre CData MCP Server for Azure Data Catalog (beta) gratuït.

Propòsit

Hem creat aquest servidor MCP només de lectura per permetre als LLMs (com Claude Desktop) consultar dades en temps real d'Azure Data Catalog suportat pel CData JDBC Driver for Azure Data Catalog.

El CData JDBC Driver es connecta a Azure Data Catalog exposant-los com a models SQL relacionals.

Aquest servidor envolta aquest driver i fa que les dades d'Azure Data Catalog estiguin disponibles a través d'una interfície MCP senzilla, de manera que els LLMs poden obtenir informació en temps real fent preguntes en llenguatge natural — sense necessitat de SQL.

Guia d'Instal·lació

1. Clona el repositori:
   

   git clone https://github.com/cdatasoftware/azure-data-catalog-mcp-server-by-cdata.git
   cd azure-data-catalog-mcp-server-by-cdata
   

2. Construeix el servidor:
   

   mvn clean install
   

   Això crea el fitxer JAR: CDataMCP-jar-with-dependencies.jar

3. Baixa i instal·la el CData JDBC Driver per a {source}: https://www.cdata.com/drivers/azuredatacatalog/download/jdbc
4. Concedeix la llicència al CData JDBC Driver:
   • Accedeix a la carpeta lib del directori d'instal·lació, normalment:
     • (Windows) C:\Program Files\CData\CData JDBC Driver for Azure Data Catalog\
     • (Mac/Linux) /Applications/CData JDBC Driver for Azure Data Catalog/
   • Executa l'ordre java -jar cdata.jdbc.azuredatacatalog.jar --license
   • Introdueix el teu nom, correu electrònic i "TRIAL" (o la teva clau de llicència).
5. Configura la teva connexió a la font de dades (exemple Salesforce):
   • Executa l'ordre java -jar cdata.jdbc.azuredatacatalog.jar per obrir l'eina de cadena de connexió.
   • Configura la cadena de connexió i fes clic a "Test Connection".

     Nota: Si la font de dades utilitza OAuth, hauràs d'autenticar-te al teu navegador.

   • Un cop exitós, copia la cadena de connexió per utilitzar-la més tard.
6. Crea un fitxer .prp per a la teva connexió JDBC (p. ex., azure-data-catalog.prp) utilitzant les propietats i format següents:
   • Prefix - un prefix a utilitzar per als eines exposats
   • ServerName - un nom per al teu servidor
   • ServerVersion - una versió per al teu servidor
   • DriverPath - el camí complet al fitxer JAR del teu controlador JDBC
   • DriverClass - el nom de la classe del controlador JDBC (p. ex., cdata.jdbc.azuredatacatalog.AzureDataCatalogDriver)
   • JdbcUrl - la cadena de connexió JDBC a utilitzar amb el CData JDBC Driver per connectar-te a les teves dades (copiada d'alguna part anterior)
   • Tables - deixa en blanc per accedir a totes les dades, o declara explícitament les taules a les quals vols crear accés

   Prefix=azuredatacatalog
   ServerName=CDataAzureDataCatalog
   ServerVersion=1.0
   DriverPath=PATH\TO\cdata.jdbc.azuredatacatalog.jar
   DriverClass=cdata.jdbc.azuredatacatalog.AzureDataCatalogDriver
   JdbcUrl=jdbc:azuredatacatalog:InitiateOAuth=GETANDREFRESH;
   Tables=
   

Utilitzar el Servidor amb Claude Desktop

1. Crea el fitxer de configuració per a Claude Desktop (claude_desktop_config.json) per afegir el nou servidor MCP, utilitzant el format següent. Si el fitxer ja existeix, afegeix l'entrada a mcpServers al fitxer de configuració.

   Windows

   {
     "mcpServers": {
       "{classname_dash}": {
         "command": "PATH\\TO\\java.exe",
         "args": [
           "-jar",
           "PATH\\TO\\CDataMCP-jar-with-dependencies.jar",
           "PATH\\TO\\azure-data-catalog.prp"
         ]
       },
       ...
     }
   }
   

   Linux/Mac

   {
     "mcpServers": {
       "{classname_dash}": {
         "command": "/PATH/TO/java",
         "args": [
           "-jar",
           "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
           "/PATH/TO/azure-data-catalog.prp"
         ]
       },
       ...
     }
   }
   

   Si cal, copia el fitxer de configuració al directori corresponent (exemple Claude Desktop).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. Executa o actualitza el teu client (Claude Desktop).

Nota: Potser hauràs de tancar completament o sortir del client Claude Desktop i tornar a obrir-lo perquè apareguin els Servidors MCP.

Executar el Servidor

1. Executa la següent ordre per fer funcionar el servidor MCP per separat:

   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp
   

Nota: El servidor utilitza stdio, de manera que només es pot utilitzar amb clients que s'executin a la mateixa màquina que el servidor.

Detalls d'Ús

Un cop configurat el servidor MCP, el client d'IA podrà utilitzar els eines integrats per llegir, escriure, actualitzar i esborrar les dades subjacents. En general, no cal cridar explícitament les eines. Simplement demana al client que respongui preguntes sobre el sistema de dades subjacents. Per exemple:

• "Quina és la correlació entre les meves oportunitats tancades guanyades i la indústria de la compte?"
• "Quants tiquets oberts tinc al projecte SUPPORT?"
• "Em pots dir quins esdeveniments del calendari tinc avui?"

La llista d'eines disponibles i les seves descripcions segueix:

Eines i Descripcions

En les definicions següents, {servername} es refereix al nom del servidor MCP al fitxer de configuració (p. ex., {classname_dash}).

• {servername}_get_tables - Recupera una llista de taules disponibles a la font de dades. Utilitza l'eina {servername}_get_columns per llistar les columnes disponibles d'una taula. La sortida de l'eina es retornarà en format CSV, amb la primera línia que conté les capçaleres de columna.
• {servername}_get_columns - Recupera una llista de columnes d'una taula. Utilitza l'eina {servername}_get_tables per obtenir una llista de taules disponibles. La sortida de l'eina es retornarà en format CSV, amb la primera línia que conté les capçaleres de columna.
• {servername}_run_query - Executa una consulta SELECT SQL.

Exemples de Sol·licituds JSON-RPC

Si estàs escrivint les sol·licituds enviades al servidor MCP en lloc d'utilitzar un client d'IA (p. ex., Claude), pots consultar els exemples de càrrega JSON a continuació – seguint la especificació JSON-RPC 2.0 – quan crides les eines disponibles.

source_get_tables

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "source_get_tables",
        "arguments": {}
    }
}

source_get_columns

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "source_get_columns",
        "arguments": {
            "table":  "Account"
        }
    }
}

source_run_query

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "source_run_query",
        "arguments": {
            "sql":  "SELECT * FROM [Account] WHERE [IsDeleted] = true"
        }
    }
}

Resolució de Problemes

1. Si no veus el teu CData MCP Server a Claude Desktop, assegura't de tancar completament Claude Desktop (Windows: utilitza el Gestor de Tasques, Mac: utilitza el Monitor d'Activitat).
2. Si Claude Desktop no pot recuperar dades, assegura't que has configurat correctament la connexió. Utilitza l'eina de construcció de cadena de connexió per crear la cadena (veure més amunt) i copia la cadena a la propietat (.prp) del fitxer.
3. Si tens problemes per connectar-te a la font de dades, contacta amb l'Equip de Suport de CData.
4. Si tens problemes per utilitzar el servidor MCP, o tens qualsevol altra retroalimentació, uneix-te a la Comunitat de CData.

Llicència

Aquest servidor MCP està llicenciat sota la Llicència MIT. Això significa que pots utilitzar, modificar i distribuir el programari lliurement, subjecte als termes i condicions de la Llicència MIT. Per a més detalls, consulta el fitxer LICENSE al repositori del projecte.

Totes les Fonts Suportades