Servidor MCP de IoTDB

👁 insignia de herrería

Descripción general

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona interacción con bases de datos y capacidades de inteligencia empresarial a través de IoTDB. Este servidor permite ejecutar consultas SQL.

Related MCP server: Microsoft SQL Server MCP Server

Componentes

Recursos

El servidor no expone ningún recurso.

Indicaciones

El servidor no proporciona ningún mensaje.

Herramientas

El servidor ofrece diferentes herramientas para el modelo de árbol y el modelo de tabla de IoTDB. Puede elegir entre ellas configurando "IOTDB_SQL_DIALECT" en "árbol" o "tabla".

Modelo de árbol

• metadata_query

  • Ejecute consultas SHOW/COUNT para leer metadatos de la base de datos

  • Aporte:

    • query_sql (cadena): La consulta SQL SHOW/COUNT que se ejecutará

  • Devuelve: Resultados de la consulta como una matriz de objetos

• select_query

  • Ejecutar consultas SELECT para leer datos de la base de datos

  • Aporte:

    • query_sql (cadena): La consulta SQL SELECT que se ejecutará

  • Devuelve: Resultados de la consulta como una matriz de objetos

Modelo de tabla

Herramientas de consulta

• read_query

  • Ejecutar consultas SELECT para leer datos de la base de datos

  • Aporte:

    • query (cadena): La consulta SQL SELECT que se ejecutará

  • Devuelve: Resultados de la consulta como una matriz de objetos

Herramientas de esquema

• list_tables

  • Obtener una lista de todas las tablas en la base de datos

  • No se requiere entrada

  • Devuelve: Matriz de nombres de tablas

• describe-table

  • Ver información del esquema para una tabla específica

  • Aporte:

    • table_name (cadena): Nombre de la tabla a describir

  • Devuelve: Matriz de definiciones de columnas con nombres y tipos

Integración de escritorio de Claude

Prerrequisitos

• Python con el gestor de paquetes uv

• Instalación de IoTDB

• Dependencias del servidor MCP

Desarrollo

# Clone the repository
git clone https://github.com/apache/iotdb-mcp-server.git
cd iotdb_mcp_server

# Create virtual environment
uv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows

# Install development dependencies
uv sync

Configure el servidor MCP en el archivo de configuración de Claude Desktop:

Sistema operativo Mac

Ubicación: ~/Library/Application Support/Claude/claude_desktop_config.json

Ventanas

Ubicación: %APPDATA%/Claude/claude_desktop_config.json

Es posible que necesites introducir la ruta completa del ejecutable uv en el campo de comandos. Puedes obtenerla ejecutando which uv en macOS/Linux o where uv en Windows.

{
 "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"
 }
 }
 }
}

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• describe_tableC
• export_table_queryA
• list_tablesB
• read_queryB