slack-mcp-servidor-de-cdata

Servidor MCP (Model Context Protocol) de CData para Slack

: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 Slack (beta).

Propósito

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

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

Este servidor envuelve ese controlador y hace que los datos de Slack estén disponibles a través de una simple interfaz MCP, por lo que los LLM 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/slack-mcp-server-by-cdata.git cd slack-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/slack/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 Slack\
     • (Mac/Linux) /Aplicaciones/CData JDBC Driver for Slack/
   • Ejecute el comando java -jar cdata.jdbc.slack.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.slack.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ás que autenticarte en tu 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, slack.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.slack.SlackDriver)
   • JdbcUrl - la cadena de conexión JDBC a utilizar con el Controlador JDBC de CData 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 para las que desea crear acceso

     Prefix=slack ServerName=CDataSlack ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.slack.jar DriverClass=cdata.jdbc.slack.SlackDriver JdbcUrl=jdbc:slack: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\\slack.prp" ] }, ... }

   Linux/Mac

   { "mcpServers": {"{classname_dash}": {"command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/slack.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.

slack_get_tables

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

slack_get_columns

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

slack_run_query

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "slack_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: use el Administrador de Tareas, Mac: use 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 alguna otra sugerencia, ú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