Сервер MCP IoTDB

Обзор

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

Компоненты

Ресурсы

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

Подсказки

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

Инструменты

Сервер предлагает различные инструменты для 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"
      }
    }
  }
}

IoTDB MCP Server

Integrations