Сервер 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 в поле команды. Вы можете получить это, запустив

{ "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" } } } }