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

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

Variable de entorno	Descripción	Por defecto
NIVEL DE REGISTRO	Establecer el nivel de registro (DEBUG, INFO, WARN, ERROR)	INFORMACIÓN
TDENGINE_HOST	Host de base de datos para el entorno	host local
PUERTO_DE_ENGINE	Puerto de base de datos	6041
TDENGINE_NOMBRE_USUARIO	Nombre de usuario de la base de datos	raíz
CONTRASEÑA DE TDENGINE	Contraseña de la base de datos	datos de Taos
BASE DE DATOS TDENGINE	Nombre de la base de datos	registro
TIEMPO DE ESPERA DEL MOTOR TDENGINE	Establezca el tiempo de espera de la conexión en segundos	30
TRANSPORTE	Controlar el transporte a utilizar	estudio

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:

Verifique las credenciales de su base de datos en su configuración de MCP
Asegúrese de que el servidor TDengine esté en ejecución y sea accesible
Comprobar las reglas del firewall que bloquean las conexiones
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.

TDengine Query MCP Server

Integrations