azuredatacatalog_get_tablesLABSCO SUMMARY
The licensed driver does the hard part.
Three tools is the whole surface, and that is the point — the JDBC driver turns Azure Data Catalog into ordinary tables, so the model writes SELECT statements instead of learning an API shape. What you trade for that is a driver install and a licensing step before the first query, and a server that only reads: there is no write, update, or delete path here.
What it is
A local Java server that puts Azure Data Catalog behind three SQL tools. CData's JDBC Driver for Azure Data Catalog exposes the service as relational tables, and this server wraps the driver so a model can find a table, read its columns, and run a SELECT against live data without anyone writing the API calls.
What you get
azuredatacatalog_get_tablesreturns the tables the driver exposes, as CSV with a header rowazuredatacatalog_get_columnsreturns the columns on one table, in the same CSV shapeazuredatacatalog_run_queryexecutes a SQL SELECT statement- The
azuredatacatalogpart is thePrefixyou set in the property file (Prefix=azuredatacatalogin the sample), so several CData servers can sit in one client without their tool names colliding - A
Tablessetting that only picks which tables also get a ready-made description (blank means none); it does not limit what the tools can list or query, so limit the connection or the account it signs in with
Requirements
Build it yourself: clone the repository and run mvn clean install, which produces CDataMCP-jar-with-dependencies.jar. Install the CData JDBC Driver for Azure Data Catalog separately and license it — java -jar cdata.jdbc.azuredatacatalog.jar --license, then name, email, and TRIAL or your key. Write a azure-data-catalog.prp file carrying DriverClass=cdata.jdbc.azuredatacatalog.AzureDataCatalogDriver and the JDBC URL from the driver's connection-string utility, and launch the server as java -jar CDataMCP-jar-with-dependencies.jar azure-data-catalog.prp. Transport is stdio, so the server runs on the same machine as the client.
Setup effort
Build from source — git clone https://github.com/cdatasoftware/azure-data-catalog-mcp-server-by-cdata.git
USE CASES
01
Answering a question about live Azure Data Catalog data
Ask in plain language; the model locates the table, checks its columns, then writes the SELECT itself.
02
Finding out what is actually available
List the tables and their columns first, so you know what can be asked before you ask it.
03
Running several CData sources in one client
Give each property file its own Prefix so the tool names stay distinct across servers.
3 tools
Listed in project docs. Your client may show a different list.
azuredatacatalog_get_columnsazuredatacatalog_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. Tool names take the Prefix in the .prp file, so the example config's names likely become azuredatacatalog_get_tables, azuredatacatalog_get_columns and azuredatacatalog_run_query. All three are read-only (run_query accepts only SELECT), despite a line promising writes.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/cdatasoftware/azure-data-catalog-mcp-server-by-cdata.git
cd azure-data-catalog-mcp-server-by-cdata
mvn clean installDownload and install the CData JDBC Driver for Azure Data Catalog from https://www.cdata.com/drivers/azuredatacatalog/download/jdbc
License the driver: in the driver's lib folder run java -jar cdata.jdbc.azuredatacatalog.jar --license, then enter name, email and "TRIAL" (or your license key)
Run java -jar cdata.jdbc.azuredatacatalog.jar to open the Connection String utility, test the connection and copy the connection string
Create a .prp file with Prefix / ServerName / ServerVersion / DriverPath / DriverClass=cdata.jdbc.azuredatacatalog.AzureDataCatalogDriver / JdbcUrl / Tables
Tables only picks which tables also get a ready-made description for your assistant, and empty means none; the server can still list and query every table your connection string reaches, so to keep data out of reach, limit that connection or the account it signs in with.
Add the mcpServers entry below to claude_desktop_config.json and restart the client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"azure-data-catalog": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_AZURE_DATA_CATALOG>"
]
}
}
}