@orphnet/d1-eloquent-mcp

Servidor MCP que le da a Claude (y a cualquier cliente compatible con Model Context Protocol) acceso en tiempo real y consciente del contexto a tu proyecto d1-eloquent - modelos, migraciones, esquema, seeders, factories y la CLI.

bunx @orphnet/d1-eloquent-mcp

Qué le ofrece a Claude

24 herramientas, 6 recursos, 2 indicaciones.

Introspección (solo lectura)

• list_models · read_model · list_migrations · read_migration · migration_status

• inspect_schema - consultar sqlite_master para ver qué hay realmente en tu D1

• query_d1 - SQL de solo lectura contra el D1 local (solo SELECT/WITH/EXPLAIN/PRAGMA)

• list_seeders · list_factories · read_file · refresh_project

• validate_model · validate_all - comparar la forma declarada del modelo contra el esquema real e informar de desviaciones

Generación (delega en la CLI de d1-eloquent)

• make_model · make_migration · make_seeder · make_factory

• make_resource - modelo + migración + seeder + factory de una sola vez

• make_pivot

Ejecución (delega en la CLI de d1-eloquent, D1 local por defecto)

• run_migrate · run_rollback · run_fresh · run_seed

• run_generate - diff de esquema: escribir la migración que cierra la brecha entre tus modelos y el esquema real

Recursos - Claude puede incorporarlos como contexto de fondo

• d1-eloquent://project/summary - el estado descubierto de tu proyecto

• 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

Indicaciones - flujos de trabajo predefinidos de varios pasos

• create-model - andamiaje + migración + verificación en un solo chat

• audit-schema - comparar cada modelo con el esquema real de D1 e informar de desviaciones

Related MCP server: Semantic D1 MCP

Instalación

Claude Code

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

Claude Desktop

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

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

Por proyecto (Claude Code)

.claude/mcp.json:

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

Para apuntar a un proyecto que no sea el directorio actual:

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

Requisitos

• Node.js ≥ 22

• wrangler instalado y autenticado para acceso a D1 (bun add -D wrangler)

• Un proyecto existente @orphnet/d1-eloquent - el servidor descubre modelos/migraciones/seeders escaneando tu árbol de archivos

Seguridad

• query_d1 rechaza cualquier cosa que no sea SELECT / WITH / EXPLAIN / PRAGMA, y rechaza cargas útiles de múltiples sentencias.

• read_file rechaza rutas que contengan .. o que empiecen con /.

• Las herramientas de generación ejecutan tu CLI d1-eloquent existente - no incluyen sus propios escritores.

• Las herramientas de ejecución (run_migrate / run_rollback / run_fresh / run_seed) solo operan en el D1 local por defecto. Para remoto, ejecuta mediante la CLI directamente.

Licencia

MIT