@orphnet/d1-eloquent-mcp

MCP-сервер, который даёт Claude (и любому Model Context Protocol-совместимому клиенту) живой, контекстно-зависимый доступ к вашему проекту d1-eloquent — модели, миграции, схема, сидеры, фабрики и CLI.

bunx @orphnet/d1-eloquent-mcp

Что это даёт Claude

24 инструмента, 6 ресурсов, 2 промпта.

Интроспекция (только чтение)

• list_models · read_model · list_migrations · read_migration · migration_status

• inspect_schema — запрос к sqlite_master, чтобы увидеть, что реально находится в вашей D1

• query_d1 — SQL только для чтения к локальной D1 (только SELECT/WITH/EXPLAIN/PRAGMA)

• list_seeders · list_factories · read_file · refresh_project

• validate_model · validate_all — сравнивают объявленную структуру модели с фактической схемой и сообщают о расхождениях

Генерация (через CLI d1-eloquent)

• make_model · make_migration · make_seeder · make_factory

• make_resource — модель + миграция + сидер + фабрика за один раз

• make_pivot

Выполнение (через CLI d1-eloquent, по умолчанию локальная D1)

• run_migrate · run_rollback · run_fresh · run_seed

• run_generate — schema-diff: создаёт миграцию, которая устраняет разрыв между вашими моделями и реальной схемой

Ресурсы — Claude может подтягивать их как фоновый контекст

• d1-eloquent://project/summary — обнаруженное состояние вашего проекта

• 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

Промпты — готовые многошаговые сценарии

• create-model — создание каркаса + миграция + проверка в одном чате

• audit-schema — сравнить каждую модель с фактической схемой D1 и сообщить о расхождениях

Related MCP server: Semantic D1 MCP

Установка

Claude Code

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

Claude Desktop

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

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

Для отдельного проекта (Claude Code)

.claude/mcp.json:

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

Чтобы указать на проект, который не является текущей директорией:

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

Требования

• Node.js ≥ 22

• wrangler, установленный и аутентифицированный для доступа к D1 (bun add -D wrangler)

• Существующий проект @orphnet/d1-eloquent — сервер обнаруживает модели/миграции/сидеры, сканируя ваше файловое дерево

Безопасность

• query_d1 отклоняет всё, кроме SELECT / WITH / EXPLAIN / PRAGMA, и отклоняет пакеты, содержащие несколько операторов.

• read_file отклоняет пути, содержащие .. или начинающиеся с /.

• Инструменты генерации обращаются к вашему существующему CLI d1-eloquent — они не включают собственные генераторы.

• Инструменты выполнения (run_migrate / run_rollback / run_fresh / run_seed) по умолчанию работают только с локальной D1. Для удалённой — запускайте напрямую через CLI.

Лицензия

MIT