@orphnet/d1-eloquent-mcp

Claude（および任意のModel Context Protocol互換クライアント）に、d1-eloquent プロジェクトへのライブでコンテキストを考慮したアクセスを提供するMCPサーバー - モデル、マイグレーション、スキーマ、シーダー、ファクトリー、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 - ローカルD1に対する読み取り専用SQL（SELECT/WITH/EXPLAIN/PRAGMAのみ）

• list_seeders · list_factories · read_file · refresh_project

• validate_model · validate_all - 宣言されたモデル形状を実際のスキーマと比較し、ドリフトを報告します

生成（d1-eloquent CLIに委任）

• make_model · make_migration · make_seeder · make_factory

• make_resource - モデル + マイグレーション + シーダー + ファクトリーを一度に生成

• make_pivot

実行（d1-eloquent CLIに委任、デフォルトではローカルD1）

• run_migrate · run_rollback · run_fresh · run_seed

• run_generate - スキーマ差分：モデルとライブスキーマのギャップを埋めるマイグレーションを作成します

リソース - 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 - 1つのチャットでスキャフォールド + マイグレーション + 検証

• 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 は .. を含むパスや / で始まるパスを拒否します。

• 生成ツールは既存のd1-eloquent CLIにシェルアウトします - 独自のライターは付属していません。

• 実行ツール（run_migrate / run_rollback / run_fresh / run_seed）はデフォルトでローカルD1に対してのみ動作します。リモートの場合は、CLIで直接実行してください。

ライセンス

MIT