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

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

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

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

Cursor IDE : настроить в .cursor/mcp.json
Anthropic Claude : использовать с совместимым клиентом MCP
Другие совместимые с MCP помощники ИИ : следуйте инструкциям по настройке MCP инструмента.

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

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

✅ Выполнять запросы 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

Переменная среды	Описание	По умолчанию
УРОВЕНЬ_ЛОГА	Установите уровень журнала (DEBUG, INFO, WARN, ERROR)	ИНФОРМАЦИЯ
TDENGINE_HOST	Хост базы данных для среды	локальный хост
TDENGINE_PORT	Порт базы данных	6041
TDENGINE_USERNAME	Имя пользователя базы данных	корень
TDENGINE_ПАРОЛЬ	Пароль базы данных	таосдата
TDENGINE_DATABASE	Имя базы данных	бревно
TDENGINE_TIMEOUT	Установите время ожидания соединения в секундах	30
ТРАНСПОРТ	Управляйте используемым транспортом	стдио

использование 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)

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

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

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

Проверьте учетные данные вашей базы данных в конфигурации MCP.
Убедитесь, что сервер TDengine запущен и доступен.
Проверьте правила брандмауэра, блокирующие соединения.
Включите режим отладки, установив LOG_LEVEL в вашей конфигурации.

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

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

Проверьте синтаксис SQL
Убедитесь, что вы используете только поддерживаемые типы запросов (SELECT, SHOW, DESCRIBE)
Убедитесь, что ваш запрос действительно доступен только для чтения

Внося вклад

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

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

MCP Server
GobinFan
-
security
F
license
-
quality
Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
Last updated -
90
Python
dbt CLI MCP Server
MammothGrowth
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that wraps the dbt CLI tool, enabling AI coding agents to interact with dbt projects through standardized MCP tools. Developed by Mammoth Growth.
Last updated -
8
Python
MIT License
MCP MySQL App
zalab-inc
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables AI assistants to interact with MySQL databases by executing SQL queries and checking database connectivity.
Last updated -
TypeScript
MIT License
MCP Starter
instructa
A
security
A
license
A
quality
A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
Last updated -
1
9
TypeScript
MIT License

View all related MCP servers

TDengine Query MCP Server