Servidor MCP de consultas TDengine

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona consultas de base de datos TDengine de solo lectura para asistentes de IA. Ejecute consultas, explore estructuras de bases de datos e investigue sus datos directamente desde sus herramientas basadas en IA.

Herramientas de IA compatibles

Este servidor MCP funciona con cualquier herramienta que admita el Protocolo de contexto de modelo, incluidas:

• Cursor IDE : configurado en .cursor/mcp.json

• Anthropic Claude : Úselo con un cliente MCP compatible

• Otros asistentes de IA compatibles con MCP : siga las instrucciones de configuración de MCP de la herramienta

Related MCP server: MCP MySQL App

Características y limitaciones

Qué hace

• ✅ Ejecutar consultas TDengine de solo lectura (solo SELECT, SHOW, DESCRIBE)

• ✅ Proporcionar información de base de datos/estable y metadatos

• ✅ Listado de bases de datos y establos disponibles

Lo que no hace

• ❌ Ejecutar operaciones de escritura (INSERTAR, ACTUALIZAR, ELIMINAR, CREAR, ALTERAR, etc.)

• ❌ Proporcionar capacidades de diseño de bases de datos o generación de esquemas

• ❌ Funciona como una herramienta completa de gestión de bases de datos

Esta herramienta está diseñada específicamente para la investigación y exploración de datos mediante consultas de solo lectura. No está diseñada para la administración de bases de datos, la gestión de esquemas ni la modificación de datos.

Cómo utilizar

Ejecutar desde el código fuente

La forma recomendada de usar este servidor MCP es ejecutarlo directamente con uv sin necesidad de instalación. Así es como Claude Desktop y Cursor están configurados para usarlo en los ejemplos a continuación.

Si desea clonar el repositorio:

Luego puedes ejecutar el servidor directamente:

Alternativamente, puede cambiar el archivo .env en el directorio src/tdengine_mcp_server/ para configurar las variables de entorno y ejecutar el servidor con el siguiente comando:

Importante: el archivo .env tendrá mayor prioridad que los argumentos de la línea de comando.

Instalar desde Pypi mediante el comando pip

y luego ejecuta:

Instalar mediante el comando uvx

Instalar desde smithery mediante el comando npx

Puedes cambiar el cliente después de la opción --client con las alternativas claude , 'windsurf', etc. También puedes consultar: smithery/tdengine-mcp-server

Opciones de configuración

archivo .env

uso de CLI

Integración con asistentes de IA

Tu asistente de IA puede interactuar con las bases de datos de TDengine a través del servidor MCP. Aquí tienes algunos ejemplos:

Consultas de ejemplo:

Uso de las herramientas MCP de TDengine

El servidor MCP de TDengine Query proporciona tres herramientas principales que su asistente de IA puede utilizar:

1. consulta

Ejecutar consultas SQL de solo lectura contra una base de datos estable específica:

2. información

Obtenga información detallada sobre su establo:

Consideraciones de seguridad

• ✅ Solo se permiten consultas de solo lectura (SELECT, SHOW, DESCRIBE)

Solución de problemas

Problemas de conexión

Si tiene problemas para conectarse:

1. Verifique las credenciales de su base de datos en su configuración de MCP

2. Asegúrese de que el servidor TDengine esté en ejecución y sea accesible

3. Comprobar las reglas del firewall que bloquean las conexiones

4. Habilite el modo de depuración configurando LOG_LEVEL en su configuración

Errores comunes

Error: Falló la ejecución de la consulta

• Verifique su sintaxis SQL

• Comprueba que solo estás utilizando tipos de consulta compatibles (SELECT, SHOW, DESCRIBE)

• Asegúrese de que su consulta sea realmente de solo lectura

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Para obtener más información o ayuda, abra un problema en el repositorio de GitHub.