这个项目能做什么
Malloy Publisher 是面向 Malloy 数据建模语言的开源分析引擎。它让用户只需定义一次数据模型,即可通过 MCP(Model Context Protocol)和 REST API 在 AI 智能体、应用和 BI 工具中复用。
主要功能包括:
- **建模(Model)**:借助内置的开源技能,从数据仓库或本地文件构建数据模型,无需重启即可验证。
- **分析(Analyze)**:通过 MCP 为 Claude、Cursor、Codex 等 AI 智能体提供查询,或通过 REST 面向无人值守的智能体和应用。
- **呈现(Surface)**:创建以 Malloy 声明的仪表板、笔记本和免构建 HTML 数据应用,全部由该包提供服务。
- **治理(Govern)**:通过 givens、`#(authorize)` 和 `#(access_filter)` 注解以及精选发现机制实现访问控制。
- **优化(Optimize)**:使用 `#@ persist` 将昂贵的源物化为表,并使用 `#@ preaggregate` 进行预聚合,可按需或按计划重建。
- **随处运行(Run anywhere)**:内置 DuckDB 支持 CSV、Parquet、JSON 和 Excel;可连接 BigQuery、Snowflake、Postgres、Databricks、MotherDuck 等;可通过 `npx`、Docker 或 Compose 部署。
快速开始:运行 `npx @malloy-publisher/server@latest --port 4000` 即可提供内置示例包(storefront、governed-analytics、html-data-app),由 DuckDB 支持,无需任何凭据。使用 `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 由 Credible 创建并维护,该公司也是 AI Analytics Engine 的背后团队,本项目基于 MIT 许可证开源。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。