ERD Makers MCP

Prisma 또는 SQL 스키마 파일을 읽어 ERD Makers 다이어그램을 분석하고 갱신하는 MCP 서버입니다.

이 패키지는 기본적으로 stdio MCP 서버로 실행됩니다. Claude Code나 Codex 같은 MCP 클라이언트는 저장소를 직접 내려받지 않고 npx로 바로 실행할 수 있습니다.

MCP 클라이언트 설정

ERD Makers에서 로그인한 뒤 우측 상단 아바타 메뉴의 MCP 설정에서 다이어그램 연동키를 발급하세요. 발급된 키 원문은 한 번만 표시되므로 바로 보관한 뒤 ERD_MAKERS_API_KEY로 설정합니다.

{
  "mcpServers": {
    "erd-makers": {
      "command": "npx",
      "args": ["-y", "erd-makers-mcp"],
      "env": {
        "ERD_MAKERS_BASE_URL": "https://erdmakers.kr",
        "ERD_MAKERS_API_KEY": "erd_dk_..."
      }
    }
  }
}

Codex에 등록

codex mcp add erd-makers \
  --env ERD_MAKERS_BASE_URL=https://erdmakers.kr \
  --env ERD_MAKERS_API_KEY=erd_dk_여기에_발급키 \
  -- npx -y erd-makers-mcp

등록 확인:

codex mcp list
codex mcp get erd-makers

삭제:

codex mcp remove erd-makers

Claude Code에 등록

모든 프로젝트에서 사용하려면 user scope로 등록합니다.

claude mcp add -s user \
  -e ERD_MAKERS_BASE_URL=https://erdmakers.kr \
  -e ERD_MAKERS_API_KEY=erd_dk_여기에_발급키 \
  erd-makers -- npx -y erd-makers-mcp

현재 프로젝트에서만 사용하려면 -s user를 -s local 또는 -s project로 바꾸세요.

등록 확인:

claude mcp list
claude mcp get erd-makers

삭제:

claude mcp remove erd-makers

공식 ERD Makers 서비스에 연결할 때 ERD_MAKERS_BASE_URL은 https://erdmakers.kr로 고정해서 사용하세요. 값을 다른 주소로 바꾸면 공식 ERD Makers와 통신하지 않으며, 잘못된 서버로 연동키가 전송될 수 있습니다.

기본값으로 ERD_MAKERS_API_KEY가 다이어그램 키 역할도 합니다. 도구 호출에서 별도 다이어그램 키를 기본값으로 쓰고 싶다면 ERD_MAKERS_DIAGRAM_KEY를 추가로 설정하세요.

환경 변수

공식 서비스를 사용할 때는 아래 값만 사용합니다. ERD_MAKERS_BASE_URL을 생략하면 패키지 기본값으로 https://erdmakers.kr이 사용됩니다.

ERD_MAKERS_BASE_URL=https://erdmakers.kr
ERD_MAKERS_API_KEY=erd_dk_...
ERD_MAKERS_DIAGRAM_KEY=erd_dk_... # 선택

보안 안내

• ERD_MAKERS_API_KEY는 해당 다이어그램을 읽고 갱신할 수 있는 연동키입니다.
• 키를 .env, .mcp.json, .npmrc, 공개 저장소, 이슈, 채팅에 올리지 마세요.
• 키가 노출되었다면 ERD Makers의 MCP 설정에서 즉시 회수하고 새 키를 발급하세요.
• 공식 서비스 사용 시 ERD_MAKERS_BASE_URL은 https://erdmakers.kr로 유지하세요.

제공 도구

• resolve_diagram: 다이어그램 제목, 현재 버전, 권한, 테이블/관계 수를 확인합니다.
• analyze_schema_changes: Prisma 또는 PostgreSQL 스키마 파일을 분석해 변경 미리보기와 proposedContent를 반환합니다.
• apply_schema_changes: 검토한 proposedContent를 baseVersion과 함께 ERD Makers에 적용합니다.
• export_diagram_sql: 현재 다이어그램을 PostgreSQL DDL 초안으로 내보냅니다.

쓰기 작업은 analyze_schema_changes 결과를 검토한 뒤 apply_schema_changes로 적용하는 흐름을 기준으로 합니다. 다이어그램 버전이 달라졌다면 409 충돌이 발생하므로 다시 분석한 뒤 적용해야 합니다.

개발

npm install
npm run dev

HTTP transport

이 npm 패키지의 기본 실행 방식은 stdio입니다. HTTP transport는 자체 호스팅이나 로컬 transport 테스트용으로만 포함되어 있으며, 현재 공개 호스팅 MCP 엔드포인트는 없습니다. 아래 localhost 예시는 개발용입니다.

ERD_MAKERS_BASE_URL=http://localhost:3214 PORT=4123 npm run dev:http

HTTP 서버를 직접 배포한다면 배포된 /mcp URL을 MCP 클라이언트에 등록하고, ERD_MAKERS_BASE_URL은 ERD Makers 앱 주소로 설정하세요.