mcp-db-wrapper-example

Der foro.sh Datenbank-Starter: ein MCP-Server, der eine kleine SQL-Datenbank kapselt. Er enthält eine Demotabelle (notes), sodass du sofort etwas abfragen kannst, sowie Werkzeuge, die dein KI-Coding-Agent zum Lesen und Schreiben nutzen kann.

Öffnest du das in Claude Code? Nichts zu installieren. Das Repository enthält die Fähigkeiten, die dein Agent braucht, in .claude/skills/: wie man diesen Server bereitstellt und wie man Werkzeuge hinzufügt, die ihren Aufwand für ein Modell wert sind.

Before you deploy

Ohne Einrichtung läuft das auf einer lokalen SQLite-Datei, die bei jedem Neustart und jeder erneuten Bereitstellung gelöscht wird – gut zum Ausprobieren, nicht für Daten, die dir wichtig sind.

Um Daten zu behalten, setze DATABASE_URL als Secret im Secrets-Tab deines Projekts (eine sqlite:///-URL, die auf eine Datei in einem von dir kontrollierten Volume verweist). Für eine völlig andere Art von Datenbank siehe Storage weiter unten.

Related MCP server: sqlite-mcp

Tools

Make it yours

Dies ist ein Ausgangspunkt, kein fertiges Produkt. Öffne dieses Repository in Claude Code (oder einem anderen KI-Coding-Agenten) und bitte es:

• die Tabellen hinzufügen, die dein Projekt tatsächlich braucht

• Werkzeuge für die spezifischen Dinge hinzufügen, die du mit deinen Daten tun möchtest – nicht nur rohes query/insert – z. B. find_customer(email), log_event(...)

• es auf eine echte Datenbank verweisen lassen, sobald du eine hast (siehe Storage weiter unten)

Du musst weder FastMCP noch das Model Context Protocol kennen, um das zu tun – beschreibe, was du willst, in einfacher Sprache und lass den Agenten den Code schreiben.

Storage

Der Datenbanktyp ist in pyproject.toml deklariert:

[tool.mcp-db-wrapper]
database = "sqlite"

server.py liest dies aus und verweigert den Start, wenn DATABASE_URL nicht dazu passt (z. B. eine nicht-sqlite:///-URL während database = "sqlite"), da der Typ eine Konfiguration ist und nicht etwas, das aus einer beliebig gesetzten URL abgeleitet wird.

Standardmäßig wird ohne DATABASE_URL-Secret auf /tmp/db.sqlite3 ausgeführt, automatisch erstellt, keine Einrichtung erforderlich, und bei jedem Neustart und jeder erneuten Bereitstellung gelöscht (die Plattform mountet keine persistenten Volumes). Setze DATABASE_URL auf einen sqlite:///-Pfad in einem von dir kontrollierten Volume, um Daten zu behalten. Für eine völlig andere Art von Datenbank (z. B. Postgres) bitte deinen Coding-Agenten, den passenden Treiber einzutauschen und das obige database entsprechend zu aktualisieren.

Run it locally

uv run server.py

Der Server spricht MCP über streamable HTTP unter http://localhost:8000/mcp (setze PORT, um den Port zu ändern – denselben Namen, den foro beim Bereitstellen für dich setzt).

Deploy it

Sein pyproject.toml ist alles, was foro.sh braucht, daher wird dieses Repository ohne Änderungen bereitgestellt: anmelden, dieses Repository auswählen, bereitstellen.