@orphnet/d1-eloquent-mcp

Claude(및 Model Context Protocol 호환 클라이언트)에게 사용자의 d1-eloquent 프로젝트(모델, 마이그레이션, 스키마, 시더, 팩토리 및 CLI)에 대한 실시간 컨텍스트 인식 액세스를 제공하는 MCP 서버입니다.

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 - 스키마 차이(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은 ..를 포함하거나 /로 시작하는 경로를 거부합니다.

• 생성 도구는 기존 d1-eloquent CLI를 호출합니다 - 자체 작성기를 포함하지 않습니다.

• 실행 도구(run_migrate / run_rollback / run_fresh / run_seed)는 기본적으로 로컬 D1에서만 작동합니다. 원격의 경우 CLI를 통해 직접 실행하세요.

라이선스

MIT