材料化 MCP 服务器

立即通过模型上下文协议 (MCP) 将你的 Materialize 索引视图转换为完全类型化的、可调用的工具。

通过创建 SQL 视图并对其进行索引来定义稳定、版本化且安全的数据工具——无需额外代码。

安装

该包可以本地安装。我们推荐使用 uv 作为构建工具。

git clone https://github.com/MaterializeInc/materialize-mcp-server
cd materialize-mcp-server
uv 运行 materialize-mcp-server

为什么不是 execute_sql？

许多数据库 MCP 服务器提供一个单一的 execute_sql 工具。 它非常适合快速原型开发，但在生产环境中 brittle。由 LLM 和代理生成的 SQL 查询可能会引入性能瓶颈、不可预测的成本和不一致的结果。

通过转向 操作数据产品，我们消除了变异性，并确保每个工具都是：

• 稳定: 定义一次，重复使用，确保一致的业务逻辑。
• 类型化: 输入和输出模式源自索引。
• 可观测: 按工具记录使用情况，使成本和性能显式化。
• 安全: 如果你没有创建视图/索引，则无法调用。

快速上手

以默认设置运行服务器：

uv 运行 materialize-mcp

配置

定义工具

1. 编写一个视图 来表达你的业务逻辑。
2. 索引 你要查询的列。
3. 注释 视图以提高可发现性。

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 order_status_summary IS '查找给定订单的状态、运输和交付信息。';

刷新服务器后，工具现在出现在 tools/list 中：

{
  "name": "order_status_summary",
  "description": "查找给定订单的状态、运输和交付信息。",
  "inputSchema": {
    "type": "object",
    "required": ["order_id"],
    "properties": {
      "order_id": { "type": "text" }
    }
  }
}