适合谁
- 处理时序和可观测性数据的开发者。
- 需要自然语言访问数据库以进行查询和分析的团队。
- 希望在MCP客户端中集成AI辅助数据探索的用户。
G
60FMRS · C
GreptimeDB MCP服务器为查询GreptimeDB提供了全面的工具集，具有强大的安全功能，如只读强制和数据掩码。维护活动，并得到上游团队的支持。对于与GreptimeDB交互的AI驱动的可观测性工作流来说非常合适。
GreptimeDB MCP服务器是一个Model Context Protocol (MCP)服务器，使AI助手能够使用SQL、TQL (PromQL兼容)和RANGE查询来查询和分析GreptimeDB中的指标、日志和链路。内置安全功能，如只读强制和数据掩码，以及管道和Perses仪表板管理。
工具能力
execute_sql
执行SQL查询，支持格式（csv/json/markdown）和行数限制。
execute_tql
执行TQL (PromQL兼容)查询，用于时间序列分析。
query_range
使用RANGE/ALIGN语法执行时间窗口聚合查询。
describe_table
检查表结构：schema、语义元数据、最新样本行和查询指南。
explain_query
分析SQL或TQL查询执行计划（analyze=true获取运行时统计；结合verbose=true获取每分区扫描指标和索引剪枝计数器）。
health_check
检查数据库连接状态和服务器版本。
list_pipelines
列出所有管道或获取特定管道的详细信息。
create_pipeline
使用YAML配置创建新管道。
dryrun_pipeline
使用示例数据测试管道，不写入数据库。
delete_pipeline
删除管道的特定版本。
list_dashboards
列出所有Perses仪表板定义。
create_dashboard
创建或更新Perses仪表板定义。
delete_dashboard
删除仪表板定义。
安装接入
- 安装：
pip install greptimedb-mcp-server。2. 运行（默认连接localhost:4002）：greptimedb-mcp-server --host localhost --database public。3. 对于Claude Desktop，将JSON配置添加到~/Library/Application Support/Claude/claude_desktop_config.json。
claude_desktop_config.json
{
"mcpServers": {
"greptimedb": {
"command": "greptimedb-mcp-server",
"args": [
"--host",
"localhost",
"--database",
"public"
]
}
}
}
选型与风险
不适合谁
- 需要写入操作或DDL/DML的用户（默认只读；仅本地/测试启用写入模式，风险极高）。
- 不使用GreptimeDB的用户。
- 不需要MCP集成但希望直接使用数据库的用户。
所需权限
- 对GreptimeDB的只读访问，用于SQL、TQL和RANGE查询。
- 访问HTTP API（默认端口4000）用于管道和仪表板管理。
- 可选：通过环境变量或CLI参数访问配置的凭据。
- 默认启用数据掩码，可防止敏感列泄露。
风险与副作用
- 如果启用写入模式（已禁用），AI可能执行破坏性SQL语句；切勿对生产环境启用。
- 查询可能因复杂或不当使用而昂贵；应限制访问和资源。
- 通过HTTP提供秘密环境变量可能增加暴露风险。
- 由于网络配置或数据库启动问题，数据库可能无法访问。
常见排障
- 检查GreptimeDB是否在指定主机和端口上运行。
- 验证连接参数（host、port、database、user、password）。
- 检查服务器日志中是否有审计记录和安全门阻止的查询。
- 对于HTTP模式，如果收到421无效主机头错误，添加允许的主机或禁用DNS重绑定保护。
使用场景
AI助手查询和分析GreptimeDB中的指标、日志和链路数据。
通过自然语言接口执行SQL和PromQL查询，用于可观测性数据。
管理管道和Perses仪表板，无需直接编写配置。
支持客户端
Claude Desktop完整支持