greptimedb-mcp-server

Name: GreptimeDB MCP Server
Author: GreptimeTeam

PyPI - Version Workflow erstellen MIT-Lizenz

Eine Model Context Protocol (MCP)-Serverimplementierung für GreptimeDB .

Dieser Server bietet KI-Assistenten eine sichere und strukturierte Möglichkeit, Datenbanken zu erkunden und zu analysieren. Er ermöglicht ihnen das Auflisten von Tabellen, das Lesen von Daten und die Ausführung von SQL-Abfragen über eine kontrollierte Schnittstelle und gewährleistet so einen verantwortungsvollen Datenbankzugriff.

Projektstatus

Dies ist ein experimentelles Projekt, das sich noch in der Entwicklung befindet. Datenschutz- und Privatsphäre-Probleme wurden nicht explizit behandelt. Bitte verwenden Sie das Projekt daher mit Vorsicht.

Funktionen

list_resources zum Auflisten von Tabellen
read_resource zum Lesen von Tabellendaten
list_tools zum Auflisten von Werkzeugen
call_tool zum Ausführen eines SQL
list_prompts zum Auflisten von Eingabeaufforderungen
get_prompt , um die Eingabeaufforderung nach Namen abzurufen

Installation

pip install greptimedb-mcp-server

Konfiguration

Legen Sie die folgenden Umgebungsvariablen fest:

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

Oder über Befehlszeilenargumente:

--host der Datenbankhost, standardmäßig localhost ,
--port der Datenbankport, muss der MySQL-Protokollport sein, standardmäßig 4002 ,
--user der Datenbankbenutzername, standardmäßig leer,
--password das Datenbankpasswort, standardmäßig leer,
--database der Datenbankname, standardmäßig public .

Verwendung

Claude Desktop Integration

Konfigurieren Sie den MCP-Server in der Konfigurationsdatei von Claude Desktop:

macOS

Speicherort: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Speicherort: %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" } } } }

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE.md.

Beitragen

Related MCP server: MCP Toolkit

Voraussetzungen

Python mit uv -Paketmanager
GreptimeDB-Installation
MCP-Serverabhängigkeiten

Entwicklung

# 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

Verwenden Sie MCP Inspector zum Debuggen:

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

Anerkennung

Die Implementierung dieser Bibliothek wurde von den folgenden beiden Repositories inspiriert und enthält deren Code, wofür wir unseren Dank aussprechen:

Danke!