M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
G

GreptimeDB MCP Server

官方
通过SQL、TQL和RANGE查询，让AI助手查询和分析GreptimeDB的指标、日志和链路。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
数据库 第 17 / 58
Stars
★ 29 热门
传输方式
stdio（本地进程）
运行环境
Python
凭据
可选 API Key
许可证
MIT
最近提交
工具数
13
60FMRS · C

GreptimeDB MCP服务器为查询GreptimeDB提供了全面的工具集，具有强大的安全功能，如只读强制和数据掩码。维护活动，并得到上游团队的支持。对于与GreptimeDB交互的AI驱动的可观测性工作流来说非常合适。

最强项 · 文档质量 14/20 最弱项 · 可靠性 10/20

可靠性
10/20
安全与权限
12/20
维护活跃度
11/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 10/20
README 描述了清晰的工具集、错误处理思路（安全门、审计日志），且声称有 CI 徽章与 pytest 测试，但本次审查未提供测试文件或 CI 工作流内容，无法静态验证工具行为与声明一致；静态校准规则限制不超过 12，扣分至 10。
安全与权限 12/20
安全设计总体良好：默认只读、安全门拦截破坏性 SQL 与编码绕过、数据脱敏、审计日志、密码标记 isSecret、DNS rebinding 防护选项。扣分点：GREPTIMEDB_ALLOW_WRITE 可完全绕过安全门且无强制确认流程；密码可用 CLI 参数传递（进程列表泄露风险）；HTTP 模式默认关闭 DNS rebinding 防护；无红线条目。
维护活跃度 11/20
MIT 许可证、版本 0.6.0 与 PyPI 包对齐、归属 GreptimeTeam 组织，显示活跃维护迹象；但仅见 29 星与 5 个开放 issue，未提供提交频率、发布节奏或安全响应渠道证据，扣分至 11。
文档质量 14/20
README 内容分层清晰：安装、CLI/环境变量、Claude Desktop 配置、安全建议（只读用户）、故障排查（421 错误）、LLM 集成文档链接。扣分：未披露成本/性能限制、脱敏的绕过边界、HTTP 模式安全权衡细节；README/manifest 属不可信证据，缺少可复核的外部佐证。
安装易用性 13/20
安装路径简单（pip install + 单命令或 Claude Desktop JSON 片段），环境变量与 CLI 参数完整，stdio 为默认传输；但 HTTP/SSE 模式需额外配置且安全默认值需要理解，静态证据限制不超过 15，扣至 13。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

  • 处理时序和可观测性数据的开发者。
  • 需要自然语言访问数据库以进行查询和分析的团队。
  • 希望在MCP客户端中集成AI辅助数据探索的用户。

不适合谁

  • 需要写入操作或DDL/DML的用户（默认只读；仅本地/测试启用写入模式，风险极高）。
  • 不使用GreptimeDB的用户。
  • 不需要MCP集成但希望直接使用数据库的用户。

所需权限

  • 对GreptimeDB的只读访问，用于SQL、TQL和RANGE查询。
  • 访问HTTP API（默认端口4000）用于管道和仪表板管理。
  • 可选：通过环境变量或CLI参数访问配置的凭据。
  • 默认启用数据掩码，可防止敏感列泄露。

风险与副作用

  • 如果启用写入模式（已禁用），AI可能执行破坏性SQL语句；切勿对生产环境启用。
  • 查询可能因复杂或不当使用而昂贵；应限制访问和资源。
  • 通过HTTP提供秘密环境变量可能增加暴露风险。
  • 由于网络配置或数据库启动问题，数据库可能无法访问。

安装接入

准备工作

运行环境：Python

GREPTIMEDB_PASSWORD 可选密钥 数据库密码，来自你的 GreptimeDB 实例配置。
其他可选配置项（17 个）
GREPTIMEDB_HOST 可选 GreptimeDB 主机地址，默认 localhost，无需申请。
GREPTIMEDB_PORT 可选 MySQL 协议端口，默认 4002。
GREPTIMEDB_USER 可选 数据库用户名，可选。
GREPTIMEDB_DATABASE 可选 要连接的数据库名，默认 public。
GREPTIMEDB_TIMEZONE 可选 会话时区，默认 UTC。
GREPTIMEDB_HTTP_PORT 可选 pipeline/dashboard 管理 HTTP API 端口，默认 4000。
GREPTIMEDB_HTTP_PROTOCOL 可选 pipeline/dashboard API 的 HTTP 协议，http 或 https，默认 http。
GREPTIMEDB_POOL_SIZE 可选 连接池大小，默认 5。
GREPTIMEDB_MASK_ENABLED 可选 是否启用敏感数据脱敏，默认 true。
GREPTIMEDB_MASK_PATTERNS 可选 额外的脱敏列名模式，逗号分隔。
GREPTIMEDB_AUDIT_ENABLED 可选 是否启用工具调用审计日志，默认 true。
GREPTIMEDB_ALLOW_WRITE 可选 允许 execute_sql 执行写入/DDL（危险，仅限本地测试），默认 false。
GREPTIMEDB_TRANSPORT 可选 传输模式：stdio、sse 或 streamable-http。
GREPTIMEDB_LISTEN_HOST 可选 HTTP 服务器绑定主机，默认 0.0.0.0。
GREPTIMEDB_LISTEN_PORT 可选 HTTP 服务器绑定端口，默认 8080。
GREPTIMEDB_ALLOWED_HOSTS 可选 DNS 重绑定保护允许的主机，逗号分隔。
GREPTIMEDB_ALLOWED_ORIGINS 可选 CORS 允许的来源，逗号分隔。
  1. 安装：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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": [
        "--host",
        "localhost",
        "--database",
        "public"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add greptimedb -- greptimedb-mcp-server --host localhost --database public

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应能看到 greptimedb 服务器的工具（如 execute_sql、health_check）；让 AI 执行 health_check，若返回数据库连接状态和服务器版本即证明安装连接成功。

常见排障

  1. 检查GreptimeDB是否在指定主机和端口上运行。
  2. 验证连接参数（host、port、database、user、password）。
  3. 检查服务器日志中是否有审计记录和安全门阻止的查询。
  4. 对于HTTP模式，如果收到421无效主机头错误，添加允许的主机或禁用DNS重绑定保护。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 查询 cpu 表最近 10 行数据并显示连接健康状态
  • 用 TQL 分析最近一小时的指标趋势
  • 为日志表创建一个新 pipeline 并先用示例数据试运行
  • 解释这条 SQL 查询的执行计划

工具能力 13

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配置创建新管道。
展开其余 5 个工具
dryrun_pipeline 只读
使用示例数据测试管道，不写入数据库。
delete_pipeline 破坏性
删除管道的特定版本。
list_dashboards 只读
列出所有Perses仪表板定义。
create_dashboard 写入
创建或更新Perses仪表板定义。
delete_dashboard 破坏性
删除仪表板定义。

使用场景

AI助手查询和分析GreptimeDB中的指标、日志和链路数据。
通过自然语言接口执行SQL和PromQL查询，用于可观测性数据。
管理管道和Perses仪表板，无需直接编写配置。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

GreptimeDB MCP服务器是一个Model Context Protocol (MCP)服务器，使AI助手能够使用SQL、TQL (PromQL兼容)和RANGE查询来查询和分析GreptimeDB中的指标、日志和链路。内置安全功能，如只读强制和数据掩码，以及管道和Perses仪表板管理。

同类可选方案

与其他 MCP 横向对比

源版本 5347e7e38002 数据同步于 2026-10-19 查看 FMRS 评分方法