avro_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 Avro 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 Avro behind three SQL tools. CData's JDBC Driver for Avro 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
avro_get_tablesreturns the tables the driver exposes, as CSV with a header rowavro_get_columnsreturns the columns on one table, in the same CSV shapeavro_run_queryexecutes a SQL SELECT statement- The
avropart is thePrefixyou set in the property file (Prefix=avroin 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 Avro separately and license it — java -jar cdata.jdbc.avro.jar --license, then name, email, and TRIAL or your key. Write a avro.prp file carrying DriverClass=cdata.jdbc.avro.AvroDriver and the JDBC URL from the driver's connection-string utility, and launch the server as java -jar CDataMCP-jar-with-dependencies.jar avro.prp. Transport is stdio, so the server runs on the same machine as the client.
Setup effort
Build from source — clone the repository, then point your client at the binary
USE CASES
01
Answering a question about live Avro 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.
avro_get_columnsavro_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. All three are read-only (run_query runs SQL SELECT only); writes need CData's separate paid server. Names start with your configured server name, and the example's InitiateOAuth setting is template text: reading a local Avro file needs no browser sign-in.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Clone the repository, then point your client at the binary. This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/cdatasoftware/avro-mcp-server-by-cdata.git
cd avro-mcp-server-by-cdata
mvn clean installDownload and install the CData JDBC Driver for Avro from https://www.cdata.com/drivers/avro/download/jdbc
License the driver: in the driver's lib folder run java -jar cdata.jdbc.avro.jar --license, then enter name, email and "TRIAL" (or your license key)
Run java -jar cdata.jdbc.avro.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.avro.AvroDriver / 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 — macOS, Linux
CLAUDE DESKTOP — MACOS, LINUX · JSON
{
"mcpServers": {
"avro": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_AVRO>"
]
}
}
}