🚀 greptimedb-mcp-server
GreptimeDB 是一款强大的时序数据库，而 greptimedb-mcp-server 则是为 GreptimeDB 专门实现的 Model Context Protocol (MCP) 服务器。它为 AI 助手提供了安全且结构化的接口，助力 AI 助手探索和分析数据库，实现负责任的数据库访问。
🚀 快速开始
greptimedb-mcp-server 为 AI 助手提供了便捷的数据库交互方式，可通过一系列功能实现对数据库的操作。
✨ 主要特性
list_resources：列出表格。read_resource：读取表格数据。list_tools：列出工具。call_tool：执行 SQL。list_prompts：列出提示。get_prompt：根据名称获取提示。
📦 安装指南
使用以下命令安装 greptimedb-mcp-server：
pip install greptimedb-mcp-server
📚 详细文档
配置
你可以通过设置环境变量或使用命令行参数来配置 greptimedb-mcp-server。
环境变量配置
GREPTIMEDB_HOST=localhost # 数据库主机
GREPTIMEDB_PORT=4002 # 可选：数据库端口（默认为 4002，未指定时使用）
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public
命令行参数配置
--host：数据库主机--port：数据库端口--user：数据库用户名--password：数据库密码--database：数据库名称
使用方法
Claude Desktop 集成
在 Claude Desktop 的配置文件中配置 MCP 服务器：
MacOS
配置文件位置：~/Library/Application Support/Claude/claude_desktop_config.json
Windows
配置文件位置：%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"greptimedb": {
"command": "uv",
"args": [
"--directory",
"/path/to/greptimedb-mcp-server",
"run",
"-m",
"greptimedb_mcp_server.server"
],
"env": {
"GREPTIMEDB_HOST": "localhost",
"GREPTIMEDB_PORT": "4002",
"GREPTIMEDB_USER": "root",
"GREPTIMEDB_PASSWORD": "",
"GREPTIMEDB_DATABASE": "public"
}
}
}
}
📄 许可证
本项目采用 MIT License，详见 LICENSE.md 文件。
🔧 技术细节
贡献
先决条件
- 带有
uv包管理器的 Python - GreptimeDB 安装
- MCP 服务器依赖项
开发
# 克隆仓库
git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git
cd greptimedb-mcp-server
# 创建虚拟环境
uv venv
source venv/bin/activate # 或 `venv\Scripts\activate` 在 Windows 上
# 安装开发依赖项
uv sync
# 运行测试
pytest
使用 MCP Inspector 进行调试：
npx @modelcontextprotocol/inspector uv \
--directory \
/path/to/greptimedb-mcp-server \
run \
-m \
greptimedb_mcp_server.server
致谢
此库的实现借鉴了以下两个仓库的代码，并表示感谢：
感谢！