Read-only-MCP-Server für den Shop

Python-MCP-Server per stdio für die vorhandene SQLite-Datenbank des Onlineshops (data/shop.db). Die Datei wird nur schreibgeschützt geöffnet; ändernde SQL-Anweisungen werden abgelehnt und nicht ausgeführt.

Installation

Python 3.11+:

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Related MCP server: sqlite-mcp-local

Start

Aus dem Projektstammverzeichnis (Standardpfad zur Datenbank — ./data/shop.db):

python -m shop_mcp
# или
shop-mcp

Anderer Pfad zur Datenbank:

SHOP_DB_PATH=~/my/test-mcp-db/data/shop.db python -m shop_mcp

Der Prozess kommuniziert über MCP via stdin/stdout. Geben Sie keine Befehle in dieses Terminal ein, solange kein MCP-Client angeschlossen ist.

MCP-Konfiguration in Cursor

Fügen Sie den Eintrag mcpServers hinzu (Cursor Settings → MCP oder .cursor/mcp.json im Projekt). Transport — stdio.

In den Beispielen ist der Pfad ~/my/test-mcp-db dieses Repository. SHOP_DB_PATH wird vom Server selbst aufgelöst (~ → Home-Verzeichnis). Wenn Cursor ~ in command / cwd nicht auflöst, geben Sie dort /Users/<вы>/my/test-mcp-db/... an.

Lokal (venv)

{
  "mcpServers": {
    "shop": {
      "command": "~/my/test-mcp-db/.venv/bin/python",
      "args": ["-m", "shop_mcp"],
      "cwd": "~/my/test-mcp-db",
      "env": {
        "SHOP_DB_PATH": "~/my/test-mcp-db/data/shop.db"
      }
    }
  }
}

Falls nach pip install -e . ein Konsolenskript bequemer ist:

{
  "mcpServers": {
    "shop": {
      "command": "~/my/test-mcp-db/.venv/bin/shop-mcp",
      "cwd": "~/my/test-mcp-db",
      "env": {
        "SHOP_DB_PATH": "~/my/test-mcp-db/data/shop.db"
      }
    }
  }
}

Docker

Das Image einmal erstellen:

docker build -t shop-mcp .

{
  "mcpServers": {
    "shop": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "~/my/test-mcp-db/data/shop.db:/data/shop.db:ro",
        "-e",
        "SHOP_DB_PATH=/data/shop.db",
        "shop-mcp"
      ]
    }
  }
}

Das Flag -i ist erforderlich, damit stdio verbunden bleibt. Mounten Sie nur shop.db; der Container darf die Datei auf dem Host nicht überschreiben.

Werkzeuge

Summen, Stückzahlen und Umsatz werden als order_items.quantity * order_items.unit_price berechnet; Bestellungen mit dem Status cancelled werden ausgeschlossen. Das Kalenderjahr wird aus strftime('%Y', orders.order_date) übernommen.

Sicherheit

• SQLite-URI file:<abs>?mode=ro

• Kommentare werden entfernt; Befehlsketten (SELECT 1; DELETE ...) werden abgelehnt

• INSERT / UPDATE / DELETE / DROP / ALTER / CREATE / ATTACH / PRAGMA / … → expliziter Fehler „nicht erlaubt“

• SQLite-Syntaxfehler und unbekannte Spalten werden strukturiert zurückgegeben; der Prozess wird nicht beendet

Hinweise zur Bewertung

• customers hat keine Spalte country. Dies ist über describe_table sichtbar; Geografie darf nicht erfunden werden. SELECT country FROM customers ergibt einen SQLite-Fehler.

• Die Bestelltermine im aktuellen Dump stammen aus dem Jahr 2026. Der Umsatz für 2025 kann 0 sein. Das ist eine korrekte Antwort und kein defekter Filter.

Tests

pytest

Die Tests kopieren data/shop.db in eine temporäre Datei und prüfen, dass sich der Hash der Kopie nach abgelehnten Schreibvorgängen nicht ändert.

Beispiel ausgeführter Abfrage