프로젝트 소개
Malloy Publisher는 Malloy 데이터 모델링 언어를 위한 오픈소스 분석 엔진입니다. 사용자는 데이터 모델을 한 번 정의하고 MCP(Model Context Protocol)와 REST API를 통해 AI 에이전트, 애플리케이션, BI 도구 전반에서 사용할 수 있습니다.
주요 기능은 다음과 같습니다:
- **Model**: 번들로 제공되는 오픈소스 스킬을 사용해 웨어하우스 또는 로컬 파일에서 데이터 모델을 구축하며, 재시작 없이 검증할 수 있습니다.
- **Analyze**: Claude, Cursor, Codex 같은 AI 에이전트를 위해 MCP를 통해 쿼리하거나, 무인 에이전트와 애플리케이션을 위해 REST를 통해 쿼리합니다.
- **Surface**: Malloy로 선언된 대시보드, 노트북, 빌드 없는 HTML 데이터 앱을 만들고 모두 패키지에서 제공합니다.
- **Govern**: givens, `#(authorize)` 및 `#(access_filter)` 애노테이션으로 접근 제어를 구현하고, 큐레이션된 검색을 제공합니다.
- **Optimize**: `#@ persist`로 비용이 큰 소스를 테이블로 구체화하고 `#@ preaggregate`로 사전 집계하며, 요청 시 또는 일정에 따라 재구축합니다.
- **Run anywhere**: CSV, Parquet, JSON, Excel을 위한 DuckDB 내장; BigQuery, Snowflake, Postgres, Databricks, MotherDuck 등에 연결; `npx`, Docker, Compose로 배포합니다.
빠른 시작: `npx @malloy-publisher/server@latest --port 4000`을 실행하면 자격 증명 없이 DuckDB를 기반으로 번들 예제 패키지(storefront, governed-analytics, html-data-app)를 제공합니다. `npm create @malloy-publisher/malloy-package@latest sales`로 새 패키지를 만들고 `-- --data ./orders.csv`로 로컬 데이터 파일을 가져올 수 있습니다.
AI 에이전트를 연결하려면 MCP 엔드포인트(기본 `http://localhost:4000/mcp` 또는 `http://127.0.0.1:4040/mcp`)를 가리키게 하세요. 서버는 시작 시 Claude Code용 `.mcp.json` 설정을 작성합니다. REST API는 모든 언어에서 사용할 수 있으며 OpenAPI 명세는 `/api-doc.yaml`에 있습니다.
보안 참고: 서버는 상태 비저장이며 인증이 없습니다. 로컬 사용 시 루프백에 바인딩하고, 더 넓게 노출할 경우 인증 게이트웨이를 앞에 두세요.
예제로는 대표적인 이커머스 모델(storefront), 거버넌스 쇼케이스(governed-analytics), 빌드 없는 HTML 대시보드(html-data-app), SDK를 사용하는 독립형 Vite + React 앱(data-app)이 있습니다.
문서는 `docs/` 폴더와 docs.malloydata.dev에 있습니다. Publisher는 AI Analytics Engine을 만든 회사인 Credible이 만들고 유지 관리하며, MIT 라이선스로 오픈소스입니다.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.