Servidor MCP de Apache IoTDB

¿Qué hace el Servidor MCP “IoTDB”?

El Servidor MCP de Apache IoTDB es una implementación del Model Context Protocol (MCP) diseñada para proporcionar capacidades de interacción con bases de datos e inteligencia de negocios a través de IoTDB, una base de datos de series temporales. Actuando como puente, permite a asistentes de IA y clientes ejecutar consultas SQL sobre IoTDB, soportando tareas de análisis y gestión de datos directamente mediante flujos de trabajo LLM en lenguaje natural o programático. Los desarrolladores pueden usar el servidor MCP para realizar consultas a la base de datos, ver información de esquemas y recuperar metadatos, facilitando la integración de IoTDB en entornos de desarrollo potenciados por IA para tareas como consulta de datos de series temporales y gestión de esquemas de base de datos.

Lista de Prompts

El servidor no proporciona ningún prompt.

Lista de Recursos

El servidor no expone recursos.

Lista de Herramientas

El Servidor MCP de IoTDB ofrece distintas herramientas según el dialecto SQL seleccionado (“tree” o “table”).

Modelo Árbol

• metadata_query
  • Ejecuta consultas SHOW/COUNT para recuperar metadatos de la base de datos IoTDB.
  • Entrada: query_sql (string) – La consulta SQL SHOW/COUNT a ejecutar.
  • Salida: Resultados de la consulta como un array de objetos.
• select_query
  • Ejecuta consultas SELECT para leer datos de series temporales de la base de datos.
  • Entrada: query_sql (string) – La consulta SQL SELECT a ejecutar.
  • Salida: Resultados de la consulta como un array de objetos.

Modelo Tabla

Herramientas de Consulta

• read_query
  • Ejecuta consultas SELECT para leer datos de la base de datos.
  • Entrada: query (string) – La consulta SQL SELECT a ejecutar.
  • Salida: Resultados de la consulta como un array de objetos.

Herramientas de Esquema

• list_tables
  • Recupera una lista de todas las tablas en la base de datos.
  • Entrada: Ninguna.
  • Salida: Array con nombres de tablas.
• describe-table
  • Proporciona información de esquema para una tabla específica.
  • Entrada: table_name (string) – Nombre de la tabla a describir.
  • Salida: Array de definiciones de columnas con nombres y tipos.

Casos de uso de este Servidor MCP

• Gestión de Bases de Datos de Series Temporales
  Consulta, explora y gestiona fácilmente grandes volúmenes de datos de series temporales almacenados en IoTDB directamente desde asistentes IA o herramientas de desarrollo potenciadas por LLM.
• Exploración de Esquemas
  Recupera y explora el esquema de la base de datos, obtén listas de tablas y descripciones de tablas para entender y documentar la estructura de la base.
• Integración con Inteligencia de Negocios
  Integra datos de IoTDB en flujos de BI con consultas en lenguaje natural y análisis de esquemas, facilitando análisis y reportes.
• Análisis de Datos Automatizado
  Usa el servidor MCP como backend para pipelines de análisis de datos automatizados, donde LLMs generan y ejecutan consultas SQL según la intención del usuario.
• Inspección de Metadatos
  Ejecuta consultas SHOW/COUNT para ver metadatos de la base de datos, ayudando en tareas de monitoreo, auditoría y optimización.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Python instalado y el gestor de paquetes uv.
2. Instala o clona el repositorio del Servidor MCP de IoTDB.
3. Edita el archivo de configuración de Windsurf para añadir el Servidor MCP de IoTDB.
4. Usa el siguiente fragmento JSON en tu configuración:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Guarda la configuración y reinicia Windsurf.
6. Verifica que el servidor esté en funcionamiento y conectado.

Claude

1. Instala Python, uv e IoTDB como requisitos previos.
2. Clona el repositorio del Servidor MCP de IoTDB.
3. En MacOS, edita ~/Library/Application Support/Claude/claude_desktop_config.json; en Windows, edita %APPDATA%/Claude/claude_desktop_config.json.
4. Agrega la entrada del servidor MCP:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Guarda los cambios y reinicia Claude Desktop.
6. Confirma que el servidor esté disponible en Claude.

Cursor

1. Asegúrate de tener Python, uv e IoTDB instalados.
2. Clona el repositorio del servidor MCP.
3. Edita la configuración de Cursor para incluir el servidor MCP.
4. Usa el siguiente JSON:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Guarda la configuración y reinicia Cursor.
6. Asegúrate de que el servidor MCP esté activo y respondiendo.

Cline

1. Instala las dependencias necesarias: Python, uv e IoTDB.
2. Clona el Servidor MCP de Apache IoTDB.
3. Abre el archivo de configuración de Cline.
4. Agrega la información del servidor MCP como sigue:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Guarda y reinicia Cline.
6. Verifica la integración del servidor MCP.

Protección de credenciales API
Las credenciales API como IOTDB_USER e IOTDB_PASSWORD se gestionan mediante el campo env en la configuración. Usa variables de entorno para evitar incluir datos sensibles directamente. Ejemplo:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

Y define estas variables de entorno en tu sistema antes de iniciar el servidor.

Cómo usar este MCP dentro de los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo en FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “iotdb” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Nuestra opinión

El Servidor MCP de IoTDB es una implementación enfocada y mínima que proporciona herramientas esenciales de interacción con bases de datos para IoTDB. Carece de funciones MCP avanzadas como prompts, recursos, raíces y muestreo, pero es muy adecuado para su caso de uso específico en acceso a bases de datos de series temporales. La configuración está bien documentada para Claude Desktop; otras integraciones se infieren pero son estándar. En general, es un servidor MCP de nicho pero sólido para flujos de trabajo centrados en bases de datos.

Puntuación MCP