FindMCP Logo FindMCP.info
greptimedb-mcp-server

greptimedb-mcp-server

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

Overview

基本能力

产品定位

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

核心功能

  • list_resources: 列出数据库中的表格
  • read_resource: 读取表格数据
  • list_tools: 列出可用工具
  • call_tool: 执行 SQL 查询
  • list_prompts: 列出提示
  • get_prompt: 根据名称获取提示

适用场景

  • AI 助手需要访问和分析数据库的场景
  • 需要安全且结构化地探索数据库的场景
  • 需要执行 SQL 查询并获取结果的场景

工具列表

  • list_resources: 列出数据库中的表格
  • read_resource: 读取表格数据
  • list_tools: 列出可用工具
  • call_tool: 执行 SQL 查询
  • list_prompts: 列出提示
  • get_prompt: 根据名称获取提示

常见问题解答

  • 如何配置数据库连接？通过环境变量或命令行参数配置数据库连接信息。
  • 如何调试？使用 MCP Inspector 工具进行调试。

使用教程

使用依赖

  • 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 开源许可条款。