Английский | 中

Обзор

Реализация сервера Model Context Protocol (MCP), которая обеспечивает взаимодействие с базой данных и возможности бизнес-аналитики через IoTDB. Этот сервер позволяет выполнять SQL-запросы и взаимодействовать с IoTDB, используя различные диалекты SQL (модель дерева и модель таблицы).

Компоненты

###Ресурсы

Сервер не раскрывает никаких ресурсов.

###Быстрые предложения

Сервер не предоставляет никаких подсказок.

Модель разрешения

Разрешения IoTDB MCP являются консультативными по умолчанию. Сервер сообщает о необходимых разрешение, уровень риска и параметр подтверждения для действий SQL; Система хост-агентов имеет одобрение пользователя. Используйте inspect_sql_permission перед выполнение DDL/DML или деструктивного SQL, когда инструмент доступен.

Долгосрочные хост-агенты могут обеспечить полный дефолт с переменные среды, такие как IOTDB_SQL_DRIVER_MODE=full и [[Т2]]. Настройка TIMESEEK_MCP_PERMISSION_ENFORCEMENT=strict только тогда, когда сам MCP-сервер должны жестко блокировать запрещенные операции.

Изменения в политике сессии ограничиваются политикой развертывания, замороженной при запуске. (процессная среда > конфигурация MCP > по умолчанию).

IoTDB MCP Server

English | 中文

Overview

A Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through IoTDB. This server enables running SQL queries and interacting with IoTDB using different SQL dialects (Tree Model and Table Model).

Components

Resources

The server doesn’t expose any resources.

Prompts

The server doesn’t provide any prompts.

Permission Model

IoTDB MCP permissions are advisory by default. The server reports the required permission, risk level, and confirmation parameter for SQL actions, while the host agent system owns user approval. Use inspect_sql_permission before executing DDL/DML or destructive SQL when the tool is available.

Long-running hosted agents can provide full-permission defaults with environment variables such as IOTDB_SQL_DRIVER_MODE=full and TIMESEEK_MCP_PERMISSION_ENFORCEMENT=advisory. Set TIMESEEK_MCP_PERMISSION_ENFORCEMENT=strict only when the MCP server itself should hard-block disallowed operations.

Session policy changes are bounded by a deployment policy frozen at startup (process environment > MCP configuration > defaults). Narrowing applies immediately; widening within that ceiling requires out-of-band administrator approval by default. IOTDB_SESSION_POLICY_APPROVAL_MODE=allow explicitly permits in-ceiling widening without approval. Neither setting allows tools to change enforcement switches, SQL classification prefixes, or the deployment ceiling. Reset and replace follow the same rules. See session policy administration for configuration, approval commands, and the required host isolation.

Tools

The server offers different tools for IoTDB Tree Model and Table Model. You can choose between them by setting the “IOTDB_SQL_DIALECT” configuration to either “tree” or “table”.

Dialect-specific identifier semantics:

• Tree dialect:
  • FROM targets use explicit root... paths.
  • Projection expressions should usually use measurement names instead of full root... paths.
  • IOTDB_DATABASE is only a connection/session hint; tree SQL still needs explicit root paths.
• Table dialect:
  • FROM targets use table names in the current database.
  • Projection expressions use column names.

Tree Model

• metadata_query
  • Execute SHOW/COUNT queries to read metadata from the database
  • Input:
    • query_sql (string): The SHOW/COUNT SQL query to execute
  • Supported query types:
    • SHOW DATABASES [path]
    • SHOW TIMESERIES [path]
    • SHOW CHILD PATHS [path]
    • SHOW CHILD NODES [path]
    • SHOW DEVICES [path]
    • COUNT TIMESERIES [path]
    • COUNT NODES [path]
    • COUNT DEVICES [path]
  • Returns: Query results as array of objects
• select_query
  • Execute SELECT queries to read data from the database
  • Input: