Materialize MCP Server

🚀 材料化 MCP 服務器

材料化 MCP 服務器能夠通過模型上下文協議 (MCP)，將你的 Materialize 索引視圖轉換為完全類型化、可調用的工具。你只需創建 SQL 視圖並對其進行索引，就能定義穩定、版本化且安全的數據工具，無需編寫額外代碼。

🚀 快速開始

以默認設置運行服務器：

uv 運行 materialize-mcp

📦 安裝指南

該包可以本地安裝。我們推薦使用 uv 作為構建工具。

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

🔧 技術細節

為什麼不是 execute_sql？

許多數據庫 MCP 服務器提供一個單一的 execute_sql 工具。它非常適合快速原型開發，但在生產環境中較為脆弱。由 LLM 和代理生成的 SQL 查詢可能會引入性能瓶頸、不可預測的成本和不一致的結果。

通過轉向 操作數據產品，我們消除了變異性，並確保每個工具具備以下特性：

• 穩定：定義一次，重複使用，確保一致的業務邏輯。
• 類型化：輸入和輸出模式源自索引。
• 可觀測：按工具記錄使用情況，使成本和性能顯式化。
• 安全：如果你沒有創建視圖/索引，則無法調用。

📚 詳細文檔

配置

定義工具

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" }
    }
  }
}