TDengine 查询 MCP 服务器
模型上下文协议 (MCP) 服务器，为 AI 助手提供只读的TDengine 数据库查询。您可以直接使用 AI 工具执行查询、探索数据库结构并调查数据。
支持的AI工具
该 MCP 服务器可与任何支持模型上下文协议的工具配合使用，包括：
Cursor IDE : 在
.cursor/mcp.json中设置Anthropic Claude ：与兼容的 MCP 客户端一起使用
其他兼容 MCP 的 AI 助手：请遵循工具的 MCP 配置说明
Related MCP server: MCP MySQL App
功能与限制
它的作用
✅ 执行只读TDengine 查询（仅限 SELECT、SHOW、DESCRIBE）
✅ 提供数据库/稳定信息和元数据
✅ 列出可用的数据库和库
它不能做什么
❌执行写操作（INSERT、UPDATE、DELETE、CREATE、ALTER 等）
❌ 提供数据库设计或模式生成功能
❌ 充当完整的数据库管理工具
此工具专为通过只读查询进行数据调查和探索而设计。它不适用于数据库管理、架构管理或数据修改。
如何使用
从源代码运行
推荐使用此 MCP 服务器的方式是直接通过uv运行，无需安装。以下示例中，Claude Desktop 和 Cursor 均采用此配置。
如果你想克隆存储库：
然后就可以直接运行服务器了：
或者，您可以更改src/tdengine_mcp_server/目录中的.env文件来设置环境变量，然后使用以下命令运行服务器：
重要提示：.env 文件的优先级高于命令行参数。
通过pip命令从 Pypi 安装
然后运行：
通过uvx命令安装
通过npx命令从 smithery 安装
您可以在--client选项后使用claude 、windsurf 等替代选项更改客户端。您也可以参考： smithery/tdengine-mcp-server
配置选项
.env 文件
环境变量 | 描述 | 默认 |
日志级别 | 设置日志级别（DEBUG、INFO、WARN、ERROR） | 信息 |
TDENGINE_HOST | 环境的数据库主机 | 本地主机 |
TDENGINE_PORT | 数据库端口 | 6041 |
TDENGINE_用户名 | 数据库用户名 | 根 |
TDENGINE_密码 | 数据库密码 | taosdata |
TDENGINE_数据库 | 数据库名称 | 日志 |
TDENGINE_超时 | 设置连接超时时间（以秒为单位） | 三十 |
运输 | 控制要使用的传输 | 标准输入输出 |
命令行用法
与人工智能助手集成
您的AI助手可以通过MCP服务器与TDengine数据库进行交互。以下是一些示例：
示例查询：
使用 TDengine MCP 工具
TDengine Query MCP 服务器提供了三个主要工具供您的 AI 助手使用：
1. 查询
针对特定表执行只读 SQL 查询：
2. 信息
获取有关您的马厩的详细信息：
安全注意事项
✅ 只允许只读查询（SELECT、SHOW、DESCRIBE）
故障排除
连接问题
如果您在连接时遇到问题：
在 MCP 配置中验证数据库凭据
确保 TDengine 服务器正在运行并且可以访问
检查防火墙规则是否阻止连接
通过在配置中设置
LOG_LEVEL来启用调试模式
常见错误
错误：查询执行失败
验证 SQL 语法
检查您是否仅使用受支持的查询类型（SELECT、SHOW、DESCRIBE）
确保您的查询确实是只读的
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
如需更多信息或支持，请在 GitHub 存储库上打开一个问题。