hubspot-mcp-server-por-cdata

Servidor de protocolo de contexto de modelo (MCP) de CData para HubSpot

: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, revise nuestro Servidor MCP de CData para HubSpot (beta).

Propósito

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

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

Este servidor envuelve ese controlador y hace que los datos de HubSpot 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. Clonar el repositorio:

   git clone https://github.com/cdatasoftware/hubspot-mcp-server-by-cdata.git cd hubspot-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/hubspot/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 HubSpot
     • (Mac/Linux) /Aplicaciones/CData JDBC Driver for HubSpot/
   • Ejecuta el comando java -jar cdata.jdbc.hubspot.jar --license
   • Introduzca su nombre, correo electrónico y "TRIAL" (o su clave de licencia).
5. Configure su conexión a la fuente de datos (Salesforce como ejemplo)

   • Ejecute el comando java -jar cdata.jdbc.hubspot.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. Cree un archivo .prp para su conexión JDBC (por ejemplo, hubspot.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.hubspot.HubSpotDriver)
   • JdbcUrl - la cadena de conexión JDBC a utilizar con el controlador 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=hubspot ServerName=CDataHubSpot ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.hubspot.jar DriverClass=cdata.jdbc.hubspot.HubSpotDriver JdbcUrl=jdbc:hubspot:InitiateOAuth=GETANDREFRESH; Tables=

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, utilizando el siguiente formato. 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\\hubspot.prp" ] }, ... }

   Linux/Mac

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

   Si es necesario, copie el archivo de configuración en el directorio adecuado (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.

hubspot_get_tables

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

hubspot_get_columns

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

hubspot_run_query

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "hubspot_run_query", "arguments": { "sql":  "SELECT * FROM [Cuenta] 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