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!

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

execute_sql

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

SQLite MCP Server
santos-404
-
security
A
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to execute SQL queries and interact with SQLite databases through a structured interface.
Last updated -
7
TypeScript
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
3
1
TypeScript
IoTDB MCP Server
JackieTien97
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to securely interact with Apache IoTDB databases through a controlled interface for listing tables, reading data, and executing SQL queries.
Last updated -
Python
MCP SQL Server
ryudg
-
security
A
license
-
quality
A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
Last updated -
4
2
TypeScript
MIT License

View all related MCP servers

GreptimeDB MCP Server