LLMSchema란? AI 코딩 에이전트에 DB 스키마를 알려주는 오픈소스 도구
- LLMSchema는 PostgreSQL·MySQL·SQLite 스키마를 마크다운으로 추출하는 오픈소스 도구입니다
- 테이블·컬럼·타입·인덱스·제약조건·관계를 하나의 포터블 문서로 생성합니다
- Go install 또는 curl 스크립트로 바로 쓸 수 있으며 개발용 DB에 권장됩니다
AI 코딩 에이전트가 데이터베이스 구조를 제대로 이해하지 못하면 작업 속도와 정확도가 떨어집니다. 해커뉴스에 올라온 오픈소스 도구 LLMSchema는 이 문제를 데이터베이스 스키마를 간결한 마크다운 문서로 뽑아내는 방식으로 풀어냅니다.
LLMSchema란 무엇인가
핵심: LLMSchema는 PostgreSQL, MySQL, SQLite의 스키마를 AI 에이전트가 읽기 쉬운 마크다운 문서로 변환해주는 오픈소스 CLI·Go 라이브러리입니다.
AI 코딩 에이전트(사용자 대신 코드를 읽고 수정·생성하는 자동화 프로그램)가 작업을 제대로 수행하려면 애플리케이션이 쓰는 데이터베이스의 구조를 알아야 합니다. 전용 스키마 문서가 없으면 에이전트는 애플리케이션 코드와 마이그레이션 기록을 뒤져서 구조를 추론해야 하는데, 이는 느리고 신뢰도가 떨어지는 방식입니다.
LLMSchema는 테이블, 컬럼, 타입, 인덱스, 제약조건, 관계(relationships)를 추출해 간결한 마크다운으로 정리합니다. 기본적으로는 테이블 목록이 포함된 단일 문서를 만들고, 필요하면 테이블별로 파일을 나눠서 생성할 수도 있습니다. 다만 이 도구는 프로덕션 환경의 핵심 문서로 쓰이기보다는 AI 지원 코딩을 돕는 개발용 데이터베이스에 쓰도록 의도됐다고 안내하고 있습니다.
설치는 Go가 설치된 환경에서 go install github.com/tordrt/llmschema/cmd/llmschema@latest 명령으로 하거나, macOS·Linux에서는 curl 기반 설치 스크립트로도 가능합니다. Go 프로젝트에 라이브러리로 직접 통합하려면 go get github.com/tordrt/llmschema로 추가할 수도 있습니다.
| 데이터베이스 | 연결 문자열 형식 |
|---|---|
| PostgreSQL | postgres://username:password@host:port/db-name |
| MySQL | mysql://username:password@host:port/db-name |
| SQLite | sqlite://path/to/db-name.db |
사용자는 DATABASE_URL 환경변수를 지정하거나 --db-url 플래그로 연결 문자열을 직접 넘겨서 llmschema -o schema.md 명령 한 번으로 전체 스키마를 마크다운 파일 하나에 기록할 수 있습니다. -t 플래그로 특정 테이블만 포함하거나 -e 플래그로 특정 테이블을 제외해, 목적에 맞춘 여러 개의 스키마 문서를 따로 관리하는 것도 가능합니다.
- 지원 데이터베이스: PostgreSQL, MySQL, SQLite
- 출력 형식: 테이블 인덱스가 포함된 단일 마크다운 문서(또는 테이블별 파일)
- 권장 용도: 프로덕션이 아닌 개발 데이터베이스, AI 코딩 에이전트 컨텍스트 제공용
출처: Hacker News | 원문 보기 ↗
이게 나에게 의미하는 것
데이터베이스가 있는 프로젝트에서 AI 코딩 에이전트를 쓰고 있다면, 스키마를 애플리케이션 코드에서 추론하게 두는 대신 LLMSchema 같은 도구로 미리 문서화해 에이전트에게 넘겨주는 방식이 더 효율적일 수 있습니다. 다만 제작사가 명시했듯 이 도구는 개발용 데이터베이스를 대상으로 설계됐으므로, 프로덕션 스키마의 정식 문서를 대체하기보다는 AI 작업을 보조하는 용도로 쓰는 것이 적절합니다.