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:

git clone https://github.com/Abeautifulsnow/tdengine-mcp.git
cd tdengine-mcp

Luego puedes ejecutar el servidor directamente:

uv run src/tdengine_mcp_server -th 192.100.8.22 -db log -ll debug

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:

uv run src/tdengine_mcp_server

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

Instalar desde Pypi mediante el comando pip

# Install globally with pip
pip install tdengine_mcp_server

y luego ejecuta:

python -m tdengine_mcp_server -h

Instalar mediante el comando uvx

uvx tdengine-mcp-server -h

Instalar desde smithery mediante el comando npx

npx -y @smithery/cli@latest install @Abeautifulsnow/tdengine-mcp --client cursor --config '"{}"'

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

$ python3 -m tdengine_mcp_server -h

usage: __main__.py [-h] [-th TAOS_HOST] [-tp TAOS_PORT] [-tu TAOS_USERNAME] [-pwd TAOS_PASSWORD] [-db TAOS_DATABASE] [-to TAOS_TIMEOUT] [-ll LOG_LEVEL]

TDengine MCP Server

options:
  -h, --help            show this help message and exit
  -th, --taos-host TAOS_HOST
                        TDengine host address. Default: `localhost`
  -tp, --taos-port TAOS_PORT
                        TDengine port number. Default: `6041`
  -tu, --taos-username TAOS_USERNAME
                        TDengine username. Default: `root`
  -pwd, --taos-password TAOS_PASSWORD
                        TDengine password. Default: `taosdata`
  -db, --taos-database TAOS_DATABASE
                        TDengine database name. Default: `default`
  -to, --taos-timeout TAOS_TIMEOUT
                        TDengine connection timeout. Default: `30`
  -ll, --log-level LOG_LEVEL
                        Log level. Default: `INFO`
  -trans, --transport {sse,stdio}
                        The transport to use. Default: `sse`

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:

Can you use the query tool to show me the first 10 records from the database?

I need to analyze our sales data. Can you run a SQL query to get the total sales per region for last month from the development database?

Can you list all the available databases we have?

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:

Use the query tool to run:

SELECT * FROM customers WHERE itemid > '2025-01-01' LIMIT 10;

2. información

Obtenga información detallada sobre su establo:

Use the info tool to check the meta info about the specified stable.

DESCRIBE disks_info;

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.