日本語 English

概要

IoTDBによるデータベースのインタラクションとビジネスインテリジェンス機能を提供するモデルコンテキストプロトコル(MCP)サーバーの実装。 このサーバーでは、SQL クエリを実行し、異なる SQL のダイアレクト (Tree Model と Table Model) を使用して IoTDB とやり取りすることができます。

コンポーネント

リソース

サーバはリソースを明示しません。

プロンプト

サーバは任意のプロンプトを提供していません。

許可モデル

IoTDB MCP 権限は、デフォルトでアドバイザリーです。 サーバは必要なレポートを報告します SQL アクションのパーミッション、リスクレベル、確認パラメータ ホストエージェントシステムは、ユーザの承認を所有しています。 前の[inspect_sql_permissionを使用してください ツールが利用可能なときに DDL/DML または破壊的な SQL を実行します。

長期的にホストされているエージェントは、フルパーミッションのデフォルトをとって提供することができます [[T1] などの環境変数 [TIMESEEK_MCP_PERMISSION_ENFORCEMENT=advisory]。 セット [[TIMESEEK_MCP_PERMISSION_ENFORCEMENT=strict] MCPサーバー自体が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: