TDengine Query MCP Server
2025.04.23
0
Python数据库查询AI 工具集成数据库
TDengine Query MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门为 AI 助手提供对 TDengine 数据库的只读查询功能。它允许用户执行查询、探索数据库结构并直接从 AI 工具中调查数据。该服务支持多种 AI 工具，如 Cursor IDE 和 Anthropic Claude，但不支持写入操作或数据库管理功能。
View on GitHub
Overview
基本能力
产品定位
TDengine Query MCP Server 是一个专为 AI 助手设计的只读数据库查询服务，用于数据调查和探索。
核心功能
- 执行只读 TDengine 查询（SELECT, SHOW, DESCRIBE）
- 提供数据库/表信息和元数据
- 列出可用的数据库和表
适用场景
- 数据调查和探索
- 通过 AI 工具进行数据库查询
- 获取数据库结构和元数据
工具列表
- query: 执行只读 SQL 查询
- info: 获取表的详细信息
常见问题解答
- 连接问题: 检查数据库凭证、确保 TDengine 服务器运行、检查防火墙规则
- 查询执行失败: 验证 SQL 语法、确保只使用支持的查询类型、确保查询是只读的
使用教程
使用依赖
无特殊依赖，直接运行或通过 pip 安装。
安装教程
从源代码运行
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
通过 pip 安装
pip install tdengine_mcp_server
python -m tdengine_mcp_server -h
调试方式
设置 LOG_LEVEL 为 DEBUG 以启用调试模式。
uv run src/tdengine_mcp_server -ll debug