SQLite MCP-Server

Überblick

Eine Model Context Protocol (MCP)-Serverimplementierung, die Datenbankinteraktion und Business Intelligence-Funktionen über SQLite bereitstellt. Dieser Server ermöglicht die Ausführung von SQL-Abfragen, die Analyse von Geschäftsdaten und die automatische Generierung von Business Insight Memos.

Komponenten

Ressourcen

Der Server stellt eine einzelne dynamische Ressource bereit:

memo://insights : Ein kontinuierlich aktualisiertes Memo mit Geschäftseinblicken, das die während der Analyse gewonnenen Erkenntnisse zusammenfasst
- Automatische Aktualisierungen, wenn über das Append-Insight-Tool neue Erkenntnisse gewonnen werden

Eingabeaufforderungen

Der Server bietet eine Demonstrationsaufforderung:

mcp-demo : Interaktive Eingabeaufforderung, die Benutzer durch Datenbankoperationen führt
- Erforderliches Argument: topic – Die zu analysierende Geschäftsdomäne
- Generiert entsprechende Datenbankschemata und Beispieldaten
- Führt Benutzer durch die Analyse und Erkenntnisgewinnung
- Integriert sich in das Business Insights Memo

Werkzeuge

Der Server bietet sechs Kerntools:

Abfragetools

read_query
- Führen Sie SELECT-Abfragen aus, um Daten aus der Datenbank zu lesen
- Eingang:
  - query (Zeichenfolge): Die auszuführende SELECT-SQL-Abfrage
- Gibt zurück: Abfrageergebnisse als Array von Objekten
write_query
- Ausführen von INSERT-, UPDATE- oder DELETE-Abfragen
- Eingang:
  - query (Zeichenfolge): Die SQL-Änderungsabfrage
- Gibt zurück: { affected_rows: number }
create_table
- Erstellen Sie neue Tabellen in der Datenbank
- Eingang:
  - query (Zeichenfolge): CREATE TABLE SQL-Anweisung
- Rückgabe: Bestätigung der Tabellenerstellung

Schema-Tools

list_tables
- Holen Sie sich eine Liste aller Tabellen in der Datenbank
- Keine Eingabe erforderlich
- Rückgabe: Array von Tabellennamen
describe-table
- Schemainformationen für eine bestimmte Tabelle anzeigen
- Eingang:
  - table_name (Zeichenfolge): Name der zu beschreibenden Tabelle
- Rückgabe: Array von Spaltendefinitionen mit Namen und Typen

Analysetools

append_insight
- Fügen Sie der Memo-Ressource neue Geschäftseinblicke hinzu
- Eingang:
  - insight (Zeichenfolge): Aus der Datenanalyse gewonnene Geschäftseinblicke
- Rücksendungen: Bestätigung der Erkenntnisaufnahme
- Löst die Aktualisierung der Ressource memo://insights aus

Verwendung mit Claude Desktop

UV

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "uv",
    "args": [
      "--directory",
      "parent_of_servers_repo/servers/src/sqlite",
      "run",
      "mcp-server-sqlite",
      "--db-path",
      "~/test.db"
    ]
  }
}

Docker

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-v",
      "mcp-test:/mcp",
      "mcp/sqlite",
      "--db-path",
      "/mcp/test.db"
    ]
  }
}

Verwendung mit VS Code

Klicken Sie zur schnellen Installation auf die folgenden Installationsschaltflächen:

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open Settings (JSON) ein.

Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der mcp -Schlüssel erforderlich ist, wenn Sie die Datei mcp.json verwenden.

UV

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path",
        "default": "${workspaceFolder}/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "uvx",
        "args": [
          "mcp-server-sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path (within container)",
        "default": "/mcp/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-sqlite:/mcp",
          "mcp/sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Gebäude

Docker:

docker build -t mcp/sqlite .

Test mit MCP-Inspector

uv add "mcp[cli]"
mcp dev src/mcp_server_sqlite/server.py:wrapper  

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.

SQLite MCP Server

Integrations