GreptimeDB MCP-Server

greptimedb-mcp-server

Workflow erstellen

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

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!

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.

Eine Serverimplementierung des Model Context Protocol, die es KI-Assistenten ermöglicht, sicher mit GreptimeDB zu interagieren, sodass sie Datenbankschemata erkunden, Daten lesen und SQL-Abfragen über eine kontrollierte Schnittstelle ausführen können.

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