Сервер MCP IoTDB

Обзор

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

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