Сервер MCP IoTDB

👁 значок кузнеца

Обзор

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

Related MCP server: Microsoft SQL Server MCP Server

Компоненты

Ресурсы

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

Подсказки

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

Инструменты

Сервер предлагает различные инструменты для IoTDB Tree Model и Table Model. Вы можете выбирать между ними, установив конфигурацию "IOTDB_SQL_DIALECT" на "tree" или "table".

Модель дерева

• metadata_query

  • Выполнение запросов SHOW/COUNT для чтения метаданных из базы данных

  • Вход:

    • query_sql (строка): SQL-запрос SHOW/COUNT для выполнения

  • Возвращает: результаты запроса в виде массива объектов.

• select_query

  • Выполнение запросов SELECT для чтения данных из базы данных

  • Вход:

    • query_sql (строка): SQL-запрос SELECT для выполнения

  • Возвращает: результаты запроса в виде массива объектов.

Модель стола

Инструменты запроса

• read_query

  • Выполнение запросов SELECT для чтения данных из базы данных

  • Вход:

    • query (строка): SQL-запрос SELECT для выполнения

  • Возвращает: результаты запроса в виде массива объектов.

Инструменты схемы

• list_tables

  • Получить список всех таблиц в базе данных

  • Ввод не требуется

  • Возвращает: Массив имен таблиц.

• describe-table

  • Просмотр информации о схеме для определенной таблицы

  • Вход:

    • table_name (string): Имя таблицы для описания

  • Возвращает: Массив определений столбцов с именами и типами.

Интеграция рабочего стола Клода

Предпосылки

• Python с менеджером пакетов uv

• Установка IoTDB

• Зависимости сервера MCP

Разработка

# 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

Настройте сервер MCP в файле конфигурации Claude Desktop:

MacOS

Расположение: ~/Library/Application Support/Claude/claude_desktop_config.json

Окна

Расположение: %APPDATA%/Claude/claude_desktop_config.json

Вам может потребоваться ввести полный путь к исполняемому файлу uv в поле команды. Вы можете получить это, запустив which uv на MacOS/Linux или where uv на 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