@orphnet/d1-eloquent-mcp

MCP-Server, der Claude (und jedem mit dem Model Context Protocol kompatiblen Client) live, kontextbezogenen Zugriff auf Ihr d1-eloquent-Projekt bietet - Modelle, Migrationen, Schema, Seeder, Fabriken und die CLI.

bunx @orphnet/d1-eloquent-mcp

Was es Claude bietet

24 Tools, 6 Ressourcen, 2 Prompts.

Introspektion (nur lesend)

• list_models · read_model · list_migrations · read_migration · migration_status

• inspect_schema - fragt sqlite_master ab, um zu sehen, was tatsächlich in Ihrer D1 ist

• query_d1 - schreibgeschütztes SQL gegen die lokale D1 (nur SELECT/WITH/EXPLAIN/PRAGMA)

• list_seeders · list_factories · read_file · refresh_project

• validate_model · validate_all - deklarierte Modellstruktur mit dem tatsächlichen Schema vergleichen, Abweichungen melden

Generierung (delegiert an die d1-eloquent CLI)

• make_model · make_migration · make_seeder · make_factory

• make_resource - Modell + Migration + Seeder + Factory in einem Zug

• make_pivot

Ausführung (delegiert an die d1-eloquent CLI, standardmäßig lokale D1)

• run_migrate · run_rollback · run_fresh · run_seed

• run_generate - Schema-Diff: schreibt die Migration, die die Lücke zwischen Ihren Modellen und dem Live-Schema schließt

Ressourcen - Claude kann diese als Hintergrundkontext einbinden

• d1-eloquent://project/summary - der ermittelte Zustand Ihres Projekts

• d1-eloquent://docs/api/base-model

• d1-eloquent://docs/api/query-builder

• d1-eloquent://docs/api/relationships

• d1-eloquent://docs/api/transactions

• d1-eloquent://docs/guide/quick-start

Prompts - vorgefertigte mehrstufige Workflows

• create-model - Scaffolding + Migration + Verifizierung in einem Chat

• audit-schema - jedes Modell mit dem tatsächlichen D1-Schema vergleichen, Abweichungen melden

Related MCP server: Semantic D1 MCP

Installation

Claude Code

claude mcp add d1-eloquent -- bunx @orphnet/d1-eloquent-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "d1-eloquent": {
      "command": "bunx",
      "args": ["@orphnet/d1-eloquent-mcp"]
    }
  }
}

Pro Projekt (Claude Code)

.claude/mcp.json:

{
  "mcpServers": {
    "d1-eloquent": {
      "command": "bunx",
      "args": ["@orphnet/d1-eloquent-mcp"]
    }
  }
}

Um auf ein Projekt zu verweisen, das nicht das aktuelle Verzeichnis ist:

{
  "mcpServers": {
    "d1-eloquent": {
      "command": "bunx",
      "args": ["@orphnet/d1-eloquent-mcp", "--project", "/path/to/your/d1-eloquent-project"]
    }
  }
}

Voraussetzungen

• Node.js ≥ 22

• wrangler installiert und für den D1-Zugriff authentifiziert (bun add -D wrangler)

• Ein bestehendes @orphnet/d1-eloquent-Projekt - der Server findet Modelle/Migrationen/Seeder, indem er Ihren Dateibaum durchsucht

Sicherheit

• query_d1 akzeptiert nur SELECT / WITH / EXPLAIN / PRAGMA und weist Nutzlasten mit mehreren Anweisungen zurück.

• read_file weist Pfade zurück, die .. enthalten oder mit / beginnen.

• Generierungswerkzeuge rufen Ihre vorhandene d1-eloquent CLI auf - sie bringen keine eigenen Writer mit.

• Ausführungswerkzeuge (run_migrate / run_rollback / run_fresh / run_seed) arbeiten standardmäßig nur mit der lokalen D1. Für Remote führen Sie die CLI direkt aus.

Lizenz

MIT