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

Признание

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

Спасибо!

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

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

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

MSSQL MCP Server
JexinSam
-
security
A
license
-
quality
A Model Context Protocol server that enables secure and structured interaction with Microsoft SQL Server databases, allowing AI assistants to list tables, read data, and execute SQL queries with controlled access.
Last updated -
20
Python
MIT License
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
108
Python
MIT License
ClickHouse MCP Server
dubin555
-
security
-
license
-
quality
A Model Context Protocol server that enables AI assistants to securely interact with ClickHouse databases, supporting table exploration and SQL query execution through a controlled interface.
Last updated -
6
Python
Apache 2.0
OceanBase MCP Server
yuanoOo
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to securely interact with OceanBase databases by listing tables, reading data, and executing SQL queries through a controlled interface.
Last updated -
1
2
Python
Apache 2.0

View all related MCP servers

GreptimeDB MCP Server