Type: GitHub Repository (오픈소스 도구) Author: Kaelio URL: https://github.com/Kaelio/ktx
Summary
ktx는 AI 에이전트(Claude Code, Codex, Cursor 등)가 SQL 웨어하우스를 정확하게 쿼리할 수 있도록 컨텍스트 레이어를 구축하는 오픈소스 도구입니다. 소스(데이터베이스, BI 도구, 위키)를 연결하여 위키와 시맨틱 레이어를 자동 생성하고, MCP를 통해 에이전트에 서비스합니다. 읽기 전용으로 설계되었으며, 로컬에서 실행되어 데이터 프라이버시를 보장합니다.
Key Insights
- 자동 컨텍스트 구축: 데이터베이스 메타데이터, dbt/Looker 정의, 위키 콘텐츠를 통합하여 중복 제거 및 모순 플래깅을 수행합니다.
- 시맨틱 레이어와 위키 결합: 전통적인 시맨틱 레이어의 한계를 극복하고 비즈니스 지식을 함께 제공합니다.
- MCP 기반 서빙: 에이전트가 표준 프로토콜을 통해 일관되게 접근할 수 있습니다.
- 보안: 모든 연결은 읽기 전용이며, LLM 제공자 외에는 데이터가 유출되지 않습니다.
Details / Notable Points
- 지원 데이터베이스: PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, SQL Server, SQLite.
- 지원 통합: dbt, MetricFlow, LookML, Looker, Metabase, Notion.
- LLM 백엔드: Anthropic API, Google Vertex AI, AI Gateway, Claude Code 세션, Codex SDK.
- 설치:
npm install -g @kaelio/ktx명령어 한 줄. - 프로젝트 구조는
ktx.yaml,semantic-layer/,wiki/를 Git에 커밋하고.ktx/는 로컬 유지.