Запрос TDengine MCP-сервера

Сервер Model Context Protocol (MCP), который предоставляет запросы базы данных TDengine только для чтения для помощников ИИ. Выполняйте запросы, исследуйте структуры баз данных и исследуйте свои данные непосредственно из инструментов на базе ИИ.

Поддерживаемые инструменты ИИ

Этот сервер MCP работает с любым инструментом, поддерживающим протокол контекста модели, включая:

• Cursor IDE : настроить в .cursor/mcp.json

• Anthropic Claude : использовать с совместимым клиентом MCP

• Другие совместимые с MCP помощники ИИ : следуйте инструкциям по настройке MCP инструмента.

Related MCP server: MCP MySQL App

Особенности и ограничения

Что это делает

• ✅ Выполнять запросы TDengine только для чтения (только SELECT, SHOW, DESCRIBE)

• ✅ Предоставление базы данных/стабильной информации и метаданных

• ✅ Список доступных баз данных и конюшен

Чего он не делает

• ❌ Выполнение операций записи (INSERT, UPDATE, DELETE, CREATE, ALTER и т. д.)

• ❌ Предоставление возможностей проектирования базы данных или генерации схем

• ❌ Функционирует как полноценный инструмент управления базой данных

Этот инструмент разработан специально для исследования и изучения данных с помощью запросов только для чтения. Он не предназначен для администрирования баз данных, управления схемами или изменения данных.

Как использовать

Запустить из исходного кода

Рекомендуемый способ использования этого сервера MCP — запустить его напрямую с uv без установки. Вот как Claude Desktop и Cursor настроены для его использования в примерах ниже.

Если вы хотите клонировать репозиторий:

git clone https://github.com/Abeautifulsnow/tdengine-mcp.git
cd tdengine-mcp

Затем вы можете запустить сервер напрямую:

uv run src/tdengine_mcp_server -th 192.100.8.22 -db log -ll debug

В качестве альтернативы вы можете изменить файл .env в каталоге src/tdengine_mcp_server/ чтобы задать переменные среды и запустить сервер с помощью следующей команды:

uv run src/tdengine_mcp_server

Важно: файл .env будет иметь более высокий приоритет , чем аргументы командной строки.

Установка из Pypi с помощью команды pip

# Install globally with pip
pip install tdengine_mcp_server

и затем запустите:

python -m tdengine_mcp_server -h

Установить командой uvx

uvx tdengine-mcp-server -h

Установить из кузницы командой npx

npx -y @smithery/cli@latest install @Abeautifulsnow/tdengine-mcp --client cursor --config '"{}"'

Вы можете изменить клиента после опции --client с альтернативами claude , 'windsurf' и т. д. Также вы можете обратиться к этому: smithery/tdengine-mcp-server

Параметры конфигурации

Файл .env

использование cli

$ python3 -m tdengine_mcp_server -h

usage: __main__.py [-h] [-th TAOS_HOST] [-tp TAOS_PORT] [-tu TAOS_USERNAME] [-pwd TAOS_PASSWORD] [-db TAOS_DATABASE] [-to TAOS_TIMEOUT] [-ll LOG_LEVEL]

TDengine MCP Server

options:
  -h, --help            show this help message and exit
  -th, --taos-host TAOS_HOST
                        TDengine host address. Default: `localhost`
  -tp, --taos-port TAOS_PORT
                        TDengine port number. Default: `6041`
  -tu, --taos-username TAOS_USERNAME
                        TDengine username. Default: `root`
  -pwd, --taos-password TAOS_PASSWORD
                        TDengine password. Default: `taosdata`
  -db, --taos-database TAOS_DATABASE
                        TDengine database name. Default: `default`
  -to, --taos-timeout TAOS_TIMEOUT
                        TDengine connection timeout. Default: `30`
  -ll, --log-level LOG_LEVEL
                        Log level. Default: `INFO`
  -trans, --transport {sse,stdio}
                        The transport to use. Default: `sse`

Интеграция с помощниками на основе искусственного интеллекта

Ваш помощник AI может взаимодействовать с базами данных TDengine через сервер MCP. Вот несколько примеров:

Примеры запросов:

Can you use the query tool to show me the first 10 records from the database?

I need to analyze our sales data. Can you run a SQL query to get the total sales per region for last month from the development database?

Can you list all the available databases we have?

Использование инструментов TDengine MCP

Сервер TDengine Query MCP предоставляет три основных инструмента, которые может использовать ваш помощник на основе искусственного интеллекта:

1. запрос

Выполнение SQL-запросов только для чтения к определенной конюшне:

Use the query tool to run:

SELECT * FROM customers WHERE itemid > '2025-01-01' LIMIT 10;

2. информация

Получите подробную информацию о вашей конюшне:

Use the info tool to check the meta info about the specified stable.

DESCRIBE disks_info;

Соображения безопасности

• ✅ Разрешены только запросы только для чтения (SELECT, SHOW, DESCRIBE)

Поиск неисправностей

Проблемы с подключением

Если у вас возникли проблемы с подключением:

1. Проверьте учетные данные вашей базы данных в конфигурации MCP.

2. Убедитесь, что сервер TDengine запущен и доступен.

3. Проверьте правила брандмауэра, блокирующие соединения.

4. Включите режим отладки, установив LOG_LEVEL в вашей конфигурации.

Распространенные ошибки

Ошибка: Не удалось выполнить запрос

• Проверьте синтаксис SQL

• Убедитесь, что вы используете только поддерживаемые типы запросов (SELECT, SHOW, DESCRIBE)

• Убедитесь, что ваш запрос действительно доступен только для чтения

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Для получения дополнительной информации или поддержки, пожалуйста, создайте проблему в репозитории GitHub.