GreptimeDB MCP-сервер

greptimedb-mcp-сервер

построить рабочий процесс

Реализация сервера Model Context Protocol (MCP) для GreptimeDB .

Этот сервер предоставляет помощникам ИИ безопасный и структурированный способ исследования и анализа баз данных. Он позволяет им перечислять таблицы, читать данные и выполнять SQL-запросы через контролируемый интерфейс, обеспечивая ответственный доступ к базе данных.

Статус проекта

Это экспериментальный проект, который все еще находится в стадии разработки. Вопросы безопасности данных и конфиденциальности не были специально рассмотрены, поэтому используйте его с осторожностью.

Возможности

list_resources для вывода списка таблиц
read_resource для чтения данных таблицы
list_tools для вывода списка инструментов
call_tool для выполнения SQL
list_prompts для вывода списка подсказок
get_prompt для получения приглашения по имени

Установка

pip install greptimedb-mcp-server

Конфигурация

Установите следующие переменные среды:

GREPTIMEDB_HOST=localhost    # Database host
GREPTIMEDB_PORT=4002         # Optional: Database MySQL port (defaults to 4002 if not specified)
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public

Или через аргументы командной строки:

--host хост базы данных, по умолчанию localhost ,
--port порт базы данных, должен быть портом протокола MySQL, по умолчанию 4002 ,
--user имя пользователя базы данных, по умолчанию пусто,
--password пароль базы данных, по умолчанию пустой,
--database имя базы данных, по умолчанию public .

Использование

Интеграция рабочего стола Клода

Настройте сервер MCP в файле конфигурации Claude Desktop:

MacOS

Расположение: ~/Library/Application Support/Claude/claude_desktop_config.json

Окна

Расположение: %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.md.

Способствовать

Предпосылки

Python с менеджером пакетов uv
Установка GreptimeDB
Зависимости сервера MCP

Разработка

# Clone the repository
git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git
cd greptimedb-mcp-server

# Create virtual environment
uv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
uv sync

# Run tests
pytest

Используйте MCP Inspector для отладки:

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

Признание

Реализация этой библиотеки была вдохновлена следующими двумя репозиториями и включает их код, за что мы выражаем нашу благодарность:

Спасибо!

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

execute_sql

Реализация сервера Model Context Protocol, которая позволяет помощникам на базе искусственного интеллекта безопасно взаимодействовать с GreptimeDB, что позволяет им исследовать схему базы данных, считывать данные и выполнять SQL-запросы через контролируемый интерфейс.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Microsoft SQL Server MCP Server
RichardHan
A
security
A
license
A
quality
A Model Context Protocol server that enables secure interaction with Microsoft SQL Server databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Last updated -
1
153
Python
MIT License
MCP MySQL App
zalab-inc
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables AI assistants to interact with MySQL databases by executing SQL queries and checking database connectivity.
Last updated -
TypeScript
MIT License
SQLite MCP Server
santos-404
-
security
A
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to execute SQL queries and interact with SQLite databases through a structured interface.
Last updated -
6
TypeScript
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
TypeScript

View all related MCP servers

GreptimeDB MCP Server