greptimedb-mcp-server

greptimedb-mcp-server

site icon
2025.03.23 0
Python数据库访问数据库控制数据库
greptimedb-mcp-server 是一个为 GreptimeDB 实现的 Model Context Protocol (MCP) 服务器。它提供了一个安全且结构化的方式,让 AI 助手能够探索和分析数据库。通过受控的接口,AI 助手可以列出表、读取数据以及执行 SQL 查询,确保对数据库的负责任访问。
View on GitHub

Overview

基本能力

产品定位

greptimedb-mcp-server 是一个数据库访问和控制工具,专为 AI 助手设计,用于安全地探索和分析 GreptimeDB 数据库。

核心功能

  • 提供安全的数据库访问接口
  • 支持列出数据库表
  • 支持读取数据
  • 支持执行 SQL 查询
  • 通过环境变量或命令行参数进行配置

适用场景

  • AI 助手需要访问和分析数据库数据
  • 需要安全地控制数据库访问权限
  • 需要结构化地探索数据库内容

工具列表

  • MCP Inspector: 用于调试 MCP 服务器的工具

常见问题解答

无明确常见问题解答部分

使用教程

使用依赖

  • Python 和 uv 包管理器
  • GreptimeDB 安装
  • MCP 服务器依赖

安装教程

pip install greptimedb-mcp-server

配置

设置以下环境变量:

GREPTIMEDB_HOST=localhost    # 数据库主机
GREPTIMEDB_PORT=4002         # 可选:数据库端口(未指定时默认为4002)
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public

或通过命令行参数: - --host 数据库主机 - --port 数据库端口 - --user 数据库用户名 - --password 数据库密码 - --database 数据库名称

调试方式

使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv \
  --directory \
  /path/to/greptimedb-mcp-server \
  run \
  -m \
  greptimedb_mcp_server.server

许可证

该项目遵循 MIT 开源许可条款。