greptimedb-mcp-сервер

Name: GreptimeDB MCP Server
Author: GreptimeTeam

PyPI - Версия построить рабочий процесс Лицензия Массачусетского технологического института

Реализация сервера 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.

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

Related MCP server: MCP Toolkit

Предпосылки

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