CData MCP Server for Microsoft SQL Server

Un servidor MCP para Microsoft SQL Server de CData. Requiere un controlador JDBC de CData con licencia por separado.

GitHub
1
Prueba este MCPPatrocinado

Documentación

microsoft-sql-server-mcp-server-by-cdata

El Servidor MCP (Model Context Protocol) de CData para Microsoft SQL Server

:heavy_exclamation_mark: Este proyecto construye un servidor MCP de solo lectura. Para capacidades completas de lectura, escritura, actualización, eliminación y acciones, junto con una configuración simplificada, consulta nuestro Servidor MCP de CData para Microsoft SQL Server (beta) gratuito.

Propósito

Creamos este Servidor MCP de solo lectura para permitir que los LLMs (como Claude Desktop) consulten datos en vivo de Microsoft SQL Server compatibles con el Controlador JDBC de CData para Microsoft SQL Server.

El Controlador JDBC de CData se conecta a Microsoft SQL Server exponiéndolos como modelos SQL relacionales.

Este servidor envuelve ese controlador y hace que los datos de Microsoft SQL Server estén disponibles a través de una interfaz MCP simple, para que los LLMs puedan recuperar información en vivo haciendo preguntas en lenguaje natural — sin necesidad de SQL.

Guía de Configuración

  1. Clona el repositorio: 
    git clone https://github.com/cdatasoftware/microsoft-sql-server-mcp-server-by-cdata.git
cd microsoft-sql-server-mcp-server-by-cdata
  2. Compila el servidor: 
    mvn clean install
    Esto crea el archivo JAR: CDataMCP-jar-with-dependencies.jar
  3. Descarga e instala el Controlador JDBC de CData para Microsoft SQL Server: https://www.cdata.com/drivers/sql/download/jdbc
  4. Licencia el Controlador JDBC de CData:
    • Navega a la carpeta lib en el directorio de instalación, típicamente:
      • (Windows) C:\Program Files\CData\CData JDBC Driver for Microsoft SQL Server\
      • (Mac/Linux) /Applications/CData JDBC Driver for Microsoft SQL Server/
    • Ejecuta el comando java -jar cdata.jdbc.sql.jar --license
    • Ingresa tu nombre, correo electrónico y "TRIAL" (o tu clave de licencia).
  5. Configura tu conexión a la fuente de datos (Salesforce como ejemplo):

    • Ejecuta el comando java -jar cdata.jdbc.sql.jar para abrir la utilidad de Cadena de Conexión.

    • Configura la cadena de conexión y haz clic en "Probar Conexión"

      Nota: Si la fuente de datos utiliza OAuth, deberás autenticarte en tu navegador.

    • Una vez exitoso, copia la cadena de conexión para usarla más adelante.

  6. Crea un archivo .prp para tu conexión JDBC (ej. microsoft-sql-server.prp) usando las siguientes propiedades y formato:
    • Prefijo - un prefijo para usar en las herramientas expuestas
    • NombreDelServidor - un nombre para tu servidor
    • VersiónDelServidor - una versión para tu servidor
    • RutaDelControlador - la ruta completa al archivo JAR de tu controlador JDBC
    • ClaseDelControlador - el nombre de la Clase del Controlador JDBC (ej. cdata.jdbc.sql.SQLDriver)
    • JdbcUrl - la cadena de conexión JDBC para usar con el Controlador JDBC de CData para conectarte a tus datos (copiada de arriba)
    • Tablas - déjalo en blanco para acceder a todos los datos, de lo contrario puedes declarar explícitamente las tablas para las que deseas crear acceso 
      Prefix=sql
ServerName=CDataSQL
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc.sql.jar
DriverClass=cdata.jdbc.sql.SQLDriver
JdbcUrl=jdbc:sql:InitiateOAuth=GETANDREFRESH;
Tables=

Usando el Servidor con Claude Desktop

  1. Crea el archivo de configuración para Claude Desktop (claude_desktop_config.json) para agregar el nuevo servidor MCP, usando el formato a continuación. Si el archivo ya existe, agrega la entrada a mcpServers en el archivo de configuración.

    Windows

    {
  "mcpServers": {
    "sql": {
      "command": "PATH\\TO\\java.exe",
      "args": [
        "-jar",
        "PATH\\TO\\CDataMCP-jar-with-dependencies.jar",
        "PATH\\TO\\microsoft-sql-server.prp"
      ]
    },
    ...
  }
}

    Linux/Mac

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

    Si es necesario, copia el archivo de configuración al 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. Ejecuta o actualiza tu cliente (Claude Desktop).

Nota: Puede que necesites salir o cerrar completamente tu cliente Claude Desktop y volver a abrirlo para que aparezcan los Servidores MCP.

Ejecutando el Servidor

  1. Ejecuta el siguiente comando para ejecutar el Servidor MCP por sí solo 
    java -jar /RUTA/A/CDataMCP-jar-with-dependencies.jar /RUTA/A/Salesforce.prp

Nota: El servidor usa stdio por lo que solo puede usarse con clientes que se ejecuten en la misma máquina que el servidor.

Detalles de Uso

Una vez que el Servidor MCP está configurado, el cliente de IA podrá usar las herramientas integradas para leer, escribir, actualizar y eliminar los datos subyacentes. En general, no necesitas llamar a las herramientas explícitamente. Simplemente pídele al cliente que responda preguntas sobre el sistema de datos subyacente. Por ejemplo:

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

La lista de herramientas disponibles y sus descripciones sigue a continuación:

Herramientas y Descripciones

En las definiciones a continuación, {servername} se refiere al nombre del Servidor MCP en el archivo de configuración (ej. sql arriba).

  • {servername}_get_tables - Recupera una lista de tablas disponibles en la fuente de datos. Usa la herramienta {servername}_get_columns para listar las columnas disponibles en una tabla. La salida de la herramienta se devolverá en formato CSV, con la primera línea conteniendo los encabezados de columna.
  • {servername}_get_columns - Recupera una lista de columnas para una tabla. Usa la herramienta {servername}_get_tables para obtener una lista de tablas disponibles. La salida de la herramienta se devolverá en formato CSV, con la primera línea conteniendo los encabezados de columna.
  • {servername}_run_query - Ejecuta una consulta SQL SELECT

Solución de Problemas

  1. Si no puedes ver tu Servidor MCP de CData en Claude Desktop, asegúrate de haber cerrado completamente Claude Desktop (Windows: usa el Administrador de Tareas, Mac: usa el Monitor de Actividad)
  2. Si Claude Desktop no puede recuperar datos, asegúrate de haber configurado tu conexión correctamente. Usa el constructor de Cadenas de Conexión para crear la cadena de conexión (ver arriba) y copia la cadena de conexión en el archivo de propiedades (.prp).
  3. Si tienes problemas para conectarte a tu fuente de datos, contacta al Equipo de Soporte de CData.
  4. Si tienes problemas usando el servidor MCP, o tienes cualquier otro comentario, únete a la Comunidad de CData.

Licencia

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

Todas las fuentes compatibles

AccessAct CRMAct-OnActive Directory
ActiveCampaignAcumaticaAdobe AnalyticsAdobe Commerce
ADPAirtableAlloyDBAmazon Athena
Amazon DynamoDBAmazon MarketplaceAmazon S3Asana
Authorize.NetAvalara AvaTaxAvroAzure Active Directory
Azure Analysis ServicesAzure Data CatalogAzure Data Lake StorageAzure DevOps
Azure SynapseAzure TableBasecampBigCommerce
BigQueryBing AdsBing SearchBitbucket
Blackbaud FE NXTBoxBullhorn CRMCassandra
CertiniaCloudantCockroachDBConfluence
Cosmos DBCouchbaseCouchDBCSV
CventDatabricksDB2DocuSign
DropboxDynamics 365Dynamics 365 Business CentralDynamics CRM
Dynamics GPDynamics NAVeBayeBay Analytics
ElasticsearchEmailEnterpriseDBEpicor Kinetic
Exact OnlineExcelExcel OnlineFacebook
Facebook AdsFHIRFreshdeskFTP
GitHubGmailGoogle Ad ManagerGoogle Ads
Google AnalyticsGoogle CalendarGoogle Campaign Manager 360Google Cloud Storage
Google ContactsGoogle Data CatalogGoogle DirectoryGoogle Drive
Google SearchGoogle SheetsGoogle SpannerGraphQL
GreenhouseGreenplumHarperDBHBase
HCL DominoHDFSHighriseHive
HubDBHubSpotIBM Cloud Data EngineIBM Cloud Object Storage
IBM InformixImpalaInstagramJDBC-ODBC Bridge
JiraJira AssetsJira Service ManagementJSON
KafkaKintoneLDAPLinkedIn
LinkedIn AdsMailChimpMariaDBMarketo
MarkLogicMicrosoft DataverseMicrosoft Entra IDMicrosoft Exchange
Microsoft OneDriveMicrosoft PlannerMicrosoft ProjectMicrosoft Teams
Monday.comMongoDBMYOB AccountRightMySQL
nCinoNeo4JNetSuiteOData
OdooOffice 365OktaOneNote
OracleOracle EloquaOracle Financials CloudOracle HCM Cloud
Oracle SalesOracle SCMOracle Service CloudOutreach.io
ParquetPaylocityPayPalPhoenix
PingOnePinterestPipedrivePostgreSQL
Power BI XMLAPrestoQuickbaseQuickBooks
QuickBooks OnlineQuickBooks TimeRaisers Edge NXTReckon
Reckon Accounts HostedRedisRedshiftREST
RSSSage 200Sage 300Sage 50 UK
Sage Cloud AccountingSage IntacctSalesforceSalesforce Data Cloud
Salesforce Financial Service CloudSalesforce MarketingSalesforce Marketing Cloud Account EngagementSalesforce Pardot
SalesloftSAPSAP Ariba ProcurementSAP Ariba Source
SAP Business OneSAP BusinessObjects BISAP ByDesignSAP Concur
SAP FieldglassSAP HANASAP HANA XS AdvancedSAP Hybris C4C
SAP Netweaver GatewaySAP SuccessFactorsSAS Data SetsSAS xpt
SendGridServiceNowSFTPSharePoint
SharePoint Excel ServicesShipStationShopifySingleStore
SlackSmartsheetSnapchat AdsSnowflake
SparkSplunkSQL Analysis ServicesSQL Server
SquareStripeSugar CRMSuiteCRM
SurveyMonkeySybaseSybase IQTableau CRM Analytics
TallyTaxJarTeradataTier1
TigerGraphTrelloTrinoTwilio
TwitterTwitter AdsVeeva CRMVeeva Vault
Wave FinancialWooCommerceWordPressWorkday
xBaseXeroXMLYouTube Analytics
ZendeskZoho BooksZoho CreatorZoho CRM
Zoho InventoryZoho ProjectsZuora... Docenas Más