Servidor MCP de IoTDB

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: XiYan 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"
      }
    }
  }
}