youtube-analytics-mcp-server-by-cdata

CData's Model Context Protocol (MCP) Server for YouTube Analytics

:heavy_exclamation_mark: Aquest projecte crea un servidor MCP només de lectura. Per a capacitats completes de lectura, escriptura, actualització, esborrat i accions, i una configuració simplificada, consulteu el nostre CData MCP Server for YouTube Analytics (beta).

Purpose

Hem creat aquest servidor MCP només de lectura per permetre que els LLM (com Claude Desktop) consultin dades en temps real de YouTube Analytics suportades pel CData JDBC Driver for YouTube Analytics.

El CData JDBC Driver connecta amb YouTube Analytics exposant-los com a models SQL relacionals.

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

Setup Guide

• Clonem el repositori:

  git clone https://github.com/cdatasoftware/youtube-analytics-mcp-server-by-cdata.git
cd youtube-analytics-mcp-server-by-cdata

• Construïm el servidor:

  mvn clean install

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

• Baixem i instal·lem el CData JDBC Driver for YouTube Analytics

• Licenciem el CData JDBC Driver:

  • Vineu a la carpeta lib del directori d'instal·lació, normalment:
  • (Windows) C:\Program Files\CData\CData JDBC Driver for YouTube Analytics\
  • (Mac/Linux) /Applications/CData JDBC Driver for YouTube Analytics/
  • Executeu la comanda java -jar cdata.jdbc.yanalytics.jar --license
  • Introduïu el vostre nom, correu electrònic i "TRIAL" (o la clau de llicència).

• Configurem la connexió a la font de dades (exemple Salesforce):

  • Executeu la comanda java -jar cdata.jdbc.yanalytics.jar per obrir l'utilitat Connection String.
  • Configureu la cadena de connexió i feu clic a "Test Connection".
  • Nota: Si la font de dades utilitza OAuth, caldrà autenticar-vos al vostre navegador.
  • Un cop exitós, copieu la cadena de connexió per a usar-la més tard.

• Creem un fitxer .prp per a la connexió JDBC (exemple youtube-analytics.prp) amb les propietats següents:

  • Prefix - prefix a utilitzar per als eines exposats
  • ServerName - nom del servidor
  • ServerVersion - versió del servidor
  • DriverPath - camí complet al fitxer JAR del driver JDBC
  • DriverClass - nom de la classe del driver JDBC (exemple cdata.jdbc.yanalytics.YAnalyticsDriver)
  • JdbcUrl - cadena de connexió JDBC a usar amb el CData JDBC Driver per connectar amb les dades (copiada d'abans)
  • Tables - deixeu en blanc per accedir a totes les dades, o declareu explícitament les taules a accedir
  Prefix=yanalytics
ServerName=CDataYAnalytics
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc.yanalytics.jar
DriverClass=cdata.jdbc.yanalytics.YAnalyticsDriver
JdbcUrl=jdbc:yanalytics:InitiateOAuth=GETANDREFRESH;
Tables=

Using the Server with Claude Desktop

• Creem 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, afegiu l'entrada a mcpServers:

  Windows

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

  Linux/Mac

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

  Si cal, copieu 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

• Executeu o actualitzeu el client (Claude Desktop).

Nota: És possible que calgui tancar completament el client Claude Desktop i tornar-lo a obrir per veure els servidors MCP.

Running the Server

• Executeu la comanda 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, per tant només es pot usar amb clients que s'executin a la mateixa màquina que el servidor.

Usage Details

Un cop configurat el servidor MCP, el client d'IA pot utilitzar els eines integrats per llegir, escriure, actualitzar i esborrar les dades subjacents. En general, no cal cridar els eines explícitament. Simplement demaneu 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 del 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:

Tools & Descriptions

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

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

JSON-RPC Request Examples

source_get_tables

source_get_columns

source_run_query

Troubleshooting

• Si no veieu el vostre CData MCP Server a Claude Desktop, assegureu-vos d'haver tancat completament Claude Desktop (Windows: utilitzeu el Gestor de tasques, Mac: utilitzeu el Monitor d'activitat).
• Si Claude Desktop no pot recuperar dades, assegureu-vos de configurar correctament la connexió. Utilitzeu l'editor de cadenes de connexió per crear la cadena (vegeu més amunt) i copieu-la al fitxer de propietats (.prp).
• Si teniu problemes per connectar amb la font de dades, contacteu amb el CData Support Team.
• Si teniu problemes amb el servidor MCP o teniu qualsevol altra retroalimentació, uniu-vos a la CData Community.

License

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

All Supported Sources