Materialize MCP Server

将Materialize中的索引视图即时转换为LLM驱动应用的实时上下文工具。

Materialize MCP Server 可将已索引并记录文档的 Materialize 视图暴露为实时、类型化、可调用的工具。这些工具可作为结构化数据的稳定 API，使模型能基于新鲜、一致且可信的信息运行。无需管道、胶水代码和陈旧缓存。

✨ 什么是操作型数据产品？

视图 + 索引 + 注释 = 操作型数据产品：自包含、版本化的服务，用于建模现实世界概念，并提供快速、可靠且可测试的动态数据访问。

🚀 快速启动

bash
uv run mcp-materialize

使用默认设置启动服务器，并立即将所有索引视图作为工具暴露。

⚙️ 配置

服务器可通过 CLI 标志或环境变量进行配置：

🛠️ 定义工具

1. 编写视图，捕获业务逻辑。
2. 创建索引，在其主键查找键上。
3. 记录文档，使用 COMMENT 语句。

sql
CREATE VIEW order_status_summary AS
SELECT o.order_id, o.status, s.carrier, c.estimated_delivery, e.delay_reason
FROM orders o
LEFT JOIN shipments s            ON o.order_id = s.order_id
LEFT JOIN carrier_tracking c     ON s.shipment_id = c.shipment_id
LEFT JOIN delivery_exceptions e ON c.tracking_id = e.tracking_id;

CREATE INDEX ON order_status_summary (order_id);

COMMENT ON VIEW order_status_summary IS
  '给定订单ID，检索当前状态、运输商、预计送达日期以及任何配送异常。使用此工具向用户显示实时订单跟踪信息。';

COMMENT ON COLUMN order_status_summary.order_id IS
  '订单的唯一标识';

现在，此工具将出现在 /tools/list 中：

json
{
  "name": "order_status_summary",
  "description": "给定订单ID，检索当前状态、运输商、预计送达日期以及任何配送异常。使用此工具向用户显示实时订单跟踪信息。",
  "inputSchema": {
    "type": "object",
    "required": ["order_id"],
    "properties": {
      "order_id": {
        "type": "text",
        "description": "订单的唯一标识"
      }
    }
  }
}