使用说明
TDengine查询MCP服务器
一种模型上下文协议（MCP）服务器，提供 只读的 用于AI助手的TDengine数据库查询。执行查询，探索数据库结构，并直接从AI驱动的工具中调查您的数据。
支持的AI工具
此MCP服务器可与支持模型上下文协议的任何工具配合使用，包括：
- 光标IDE：设置在
.cursor/mcp.json - 人物克劳德：与兼容的MCP客户端一起使用
- 其他与MCP兼容的AI助手：遵循工具的MCP配置说明
功能和限制
它做什么
- ✅ 执行 只读的 TD引擎查询（仅限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“风帆冲浪”等等。你也可以参考这个： smithery/tdengine mcp服务器
配置选项
.env文件
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| LOGLEVEL | 设置日志级别（调试、信息、警告、错误） | 信息 |
| TDENGINE_HOST | 环境数据库主机 | localhost |
| TDENGINE_PORT | 数据库端口 | 6041 |
| TDENGINE_USENAME | 数据库用户名 | root |
| TDENGINE_PASSWORD | 数据库密码 | taosdata |
| TDENGINE_DATABASE | 数据库名称 | 日志 |
| TDENGINE_TIMEOUT | 设置连接超时时间（秒） | 30 |
| TRANSPORT | 控制传输使用 | stdio |
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助手集成
您的AI助手可以通过MCP服务器与TDengine数据库进行交互。以下是一些示例：
示例查询：
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服务器为您的AI助手提供了三个主要工具：
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存储库上。
