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.

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

IoTDB MCP Server

Integrations