greptimedb-mcp-server

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

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:

• ktanaka101/mcp-server-duckdb

• designcomputer/mysql_mcp_server

• mikeskarl/mcp-prompt-templates

Danke!

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