SQLite Explorer MCP-Server

Ein MCP-Server, der sicheren, schreibgeschützten Zugriff auf SQLite-Datenbanken über das Model Context Protocol (MCP) bietet. Dieser Server basiert auf dem FastMCP-Framework, das LLMs die Untersuchung und Abfrage von SQLite-Datenbanken mit integrierten Sicherheitsfunktionen und Abfragevalidierung ermöglicht.

📋 Systemanforderungen

• Python 3.6+

• SQLite-Datenbankdatei (Pfad über Umgebungsvariable angegeben)

Related MCP server: Jewei MSSQL MCP Server

📦 Abhängigkeiten

Installieren Sie alle erforderlichen Abhängigkeiten:

# Using pip
pip install -r requirements.txt

Erforderliche Pakete

• fastmcp : Framework zum Erstellen von Model Context Protocol-Servern

Zur einfachen Installation sind alle Abhängigkeiten in requirements.txt angegeben.

📑 Inhaltsverzeichnis

• Systemanforderungen

• Abhängigkeiten

• MCP-Tools

• Erste Schritte

• Installationsoptionen

  • Claude Desktop

  • Cline VSCode-Plugin

• Sicherheitsfunktionen

• Entwicklungsdokumentation

• Umgebungsvariablen

🛠️ MCP-Tools

Der Server stellt LLMs die folgenden Tools zur Verfügung:

Abfrage lesen

Führen Sie eine SELECT-Abfrage in der Datenbank mit integrierten Sicherheitsüberprüfungen aus. Funktionen:

• Abfragevalidierung und -bereinigung

• Unterstützung der Parameterbindung

• Durchsetzung der Zeilenbegrenzung

• Ergebnisse als Wörterbücher formatiert

list_tables

Listet alle verfügbaren Tabellen in der Datenbank mit ihren Namen auf.

Tabelle beschreiben

Erhalten Sie detaillierte Schemainformationen für eine bestimmte Tabelle, einschließlich:

• Spaltennamen und -typen

• NULL-Einschränkungen

• Standardwerte

• Primärschlüsselinformationen

🚀 Erste Schritte

Klonen Sie das Repository:

git clone https://github.com/hannesrudolph/sqlite-explorer-fastmcp-mcp-server.git
cd sqlite-explorer-fastmcp-mcp-server

📦 Installationsoptionen

Sie können diesen MCP-Server entweder in Claude Desktop oder im Cline VSCode-Plugin installieren. Wählen Sie die Option, die Ihren Anforderungen am besten entspricht.

Option 1: Für Claude Desktop installieren

Installation mit FastMCP:

fastmcp install sqlite_explorer.py --name "SQLite Explorer" -e SQLITE_DB_PATH=/path/to/db

Ersetzen Sie /path/to/db durch den Pfad zu Ihrer SQLite-Datenbankdatei.

Option 2: Installation für das Cline VSCode-Plugin

So verwenden Sie diesen Server mit dem Cline VSCode-Plugin :

1. Klicken Sie in VSCode auf das Serversymbol (☰) in der Seitenleiste des Cline-Plugins.

2. Klicken Sie auf die Schaltfläche „MCP-Einstellungen bearbeiten“ (✎).

3. Fügen Sie der Einstellungsdatei die folgende Konfiguration hinzu:

{
  "sqlite-explorer": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "--with",
      "uvicorn",
      "fastmcp",
      "run",
      "/path/to/repo/sqlite_explorer.py"
    ],
    "env": {
      "SQLITE_DB_PATH": "/path/to/your/database.db"
    }
  }
}

Ersetzen:

• /path/to/repo mit dem vollständigen Pfad zu dem Ort, an dem Sie dieses Repository geklont haben (z. B. /Users/username/Projects/sqlite-explorer-fastmcp-mcp-server )

• /path/to/your/database.db mit dem vollständigen Pfad zu Ihrer SQLite-Datenbankdatei

🔒 Sicherheitsfunktionen

• Lesezugriff auf SQLite-Datenbanken

• Abfragevalidierung und -bereinigung

• Parameterbindung für sichere Abfrageausführung

• Durchsetzung der Zeilenbegrenzung

• Unterdrückung der Fortschrittsausgabe für saubere JSON-Antworten

📚 Entwicklungsdokumentation

Das Repository enthält Dokumentationsdateien für die Entwicklung:

• mcp-documentation.txt : Enthält eine umfassende Dokumentation zur MCP-Serverimplementierung und zur Verwendung des FastMCP-Frameworks.

Diese Dokumentation dient als Kontext bei der Entwicklung von Funktionen und kann mit LLMs zur Unterstützung der Entwicklung verwendet werden.

⚙️ Umgebungsvariablen

Die folgenden Umgebungsvariablen müssen festgelegt werden:

• SQLITE_DB_PATH : Vollständiger Pfad zur SQLite-Datenbankdatei, die Sie untersuchen möchten