greptimedb-mcp-сервер

👁 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: SQLite MCP Server

Предпосылки

• 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

Признание

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

• ktanaka101/mcp-сервер-duckdb

• designcomputer/mysql_mcp_server

• mikeskarl/mcp-prompt-шаблоны

Спасибо!

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_dashboardC
• create_pipelineC
• delete_dashboardC
• delete_pipelineB
• describe_tableA
• dryrun_pipelineA
• execute_sqlA
• execute_tqlC