youtube-analytics-mcp-server-by-cdata

Servidor de protocolo de contexto de modelo (MCP) de CData para YouTube Analytics

:heavy_exclamation_mark: Este proyecto construye un servidor MCP de sólo lectura. Para capacidades completas de lectura, escritura, actualización, borrado y acción y una configuración simplificada, echa un vistazo a nuestro servidor gratuito CData MCP para YouTube Analytics (beta).

Propósito

Creamos este Servidor MCP de sólo lectura para permitir a los LLMs (como Claude Desktop) consultar datos en vivo de YouTube Analytics soportados por el CData JDBC Driver para YouTube Analytics.

CData JDBC Driver se conecta a YouTube Analytics exponiéndolos como modelos SQL relacionales.

Este servidor envuelve ese controlador y hace que los datos de YouTube Analytics estén disponibles a través de una sencilla interfaz MCP, por lo que los LLMs pueden recuperar información en vivo haciendo preguntas en lenguaje natural - sin necesidad de SQL.

Guía de instalación

1. Clona el repositorio:

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

2. Construir el servidor:

   mvn clean install

   Esto crea el archivo JAR: CDataMCP-jar-con-dependencias.jar
3. Descargue e instale el CData JDBC Driver para {source}: https://www.cdata.com/drivers/youtubeanalytics/download/jdbc
4. Licenciar el CData JDBC Driver
   • Navegue a la carpeta lib en el directorio de instalación, típicamente
     • (Windows) C:Archivos de programa\CData\CData JDBC Driver for YouTube Analytics\
     • (Mac/Linux) /Aplicaciones/CData JDBC Driver for YouTube Analytics/
   • Ejecute el comando java -jar cdata.jdbc.yanalytics.jar --license
   • Introduce tu nombre, correo electrónico y "TRIAL" (o tu clave de licencia).
5. Configure su conexión a la fuente de datos (Salesforce como ejemplo)

   • Ejecute el comando java -jar cdata.jdbc.yanalytics.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, tendrá que autenticarse en su navegador.

   • Una vez autenticado, copie la cadena de conexión para utilizarla más adelante.

6. Crea un archivo .prp para tu conexión JDBC (por ejemplo, youtube-analytics.prp) con las siguientes propiedades y formato
   • Prefix - un prefijo que se utilizará para las herramientas expuestas
   • ServerName: nombre del servidor
   • ServerVersion - una versión para su servidor
   • DriverPath - la ruta completa al archivo JAR de su controlador JDBC
   • DriverClass - el nombre de la clase del controlador JDBC (por ejemplo, cdata.jdbc.yanalytics.YAnalyticsDriver)
   • JdbcUrl - la cadena de conexión JDBC a utilizar con el Driver CData JDBC para conectarse a sus datos (copiado de arriba)
   • Tables - déjelo en blanco para acceder a todos los datos, de lo contrario puede declarar explícitamente las tablas a las que desea crear acceso para

     Prefix=yanalytics ServerName=CDataYAnalytics ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.yanalytics.jar DriverClass=cdata.jdbc.yanalytics.YAnalyticsDriver JdbcUrl=jdbc:yanalytics:InitiateOAuth=GETANDREFRESH; Tablas=

Uso del servidor con Claude Desktop

1. Cree el archivo de configuración para Claude Desktop ( claude_desktop_config.json) para añadir el nuevo servidor MCP, usando el formato de abajo. Si el archivo ya existe, añada la entrada a mcpServers en el archivo config.

   Windows

   { "mcpServers": { "{classname_dash}": {"comando": "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 es necesario, copie el archivo de configuración en el 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 tenga que salir o cerrar completamente su cliente Claude Desktop y volver a abrirlo para que aparezcan los Servidores MCP.

Ejecutar el Servidor

1. Ejecute el siguiente comando para ejecutar el servidor MCP en su propio

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

Nota: El servidor utiliza stdio, por lo que sólo puede utilizarse con clientes que se ejecuten en la misma máquina que el servidor.

Detalles de uso

Una vez configurado el servidor MCP, el cliente AI podrá utilizar las herramientas integradas para leer, escribir, actualizar y eliminar los datos subyacentes. En general, no es necesario llamar explícitamente a las herramientas. Basta con pedir al cliente que responda a preguntas sobre el sistema de datos subyacente. Por ejemplo:

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

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

Herramientas y descripciones

En las definiciones siguientes, {servername} se refiere al nombre del servidor MCP en el archivo de configuración (por ejemplo, {classname_dash} arriba).

• {servername}_get_tables - Recupera una lista de tablas disponibles en la fuente de datos. Utilice la herramienta {servername}_get_columns para obtener una lista de las columnas disponibles en una tabla. La salida de la herramienta se devolverá en formato CSV, con la primera línea conteniendo las cabeceras de las columnas.
• {servername}_get_columns - Recupera una lista de columnas de 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 conteniendo las cabeceras de las columnas.
• {servername}_run_query - Ejecutar una consulta SQL SELECT

Ejemplos de peticiones JSON-RPC

Si está programando las solicitudes enviadas al servidor MCP en lugar de utilizar un cliente AI (por ejemplo, Claude), puede consultar los siguientes ejemplos de carga útil JSON (siguiendo la especificación JSON-RPC 2.0) al llamar a las herramientas 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" } }

Solución de problemas

1. Si no puede ver su Servidor CData MCP en Claude Desktop, asegúrese de que ha salido completamente de Claude Desktop (Windows: utilice el Administrador de Tareas, Mac: utilice el Monitor de Actividad)
2. Si Claude Desktop no puede recuperar datos, asegúrese de que ha configurado su conexión correctamente. Utilice el generador de cadenas de conexión para crear la cadena de conexión (véase más arriba) y cópiela en el archivo de propiedades (.prp).
3. Si tiene problemas para conectarse a su fuente de datos, póngase en contacto con el equipo de soporte de CData.
4. Si tiene problemas para utilizar el servidor MCP, o tiene cualquier otro comentario, únase a la Comunidad CData.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.

Todas las fuentes compatibles