Materialize MCP Server

🚀 材料化 MCP サーバ

モデルコンテキストプロトコル (MCP) を通じて、あなたの Materialize インデックスビューを完全に型付けされた呼び出し可能なツールにすぐに変換できます。

SQL ビューを作成してインデックスを付けることで、追加のコードなしで、安定した、バージョン管理された、安全なデータツールを定義できます。

🚀 クイックスタート

デフォルト設定でサーバを起動します。

uv 运行 materialize-mcp

✨ 主な機能

多くのデータベース MCP サーバは、単一の execute_sql ツールを提供します。これは迅速なプロトタイピングには適していますが、本番環境では脆弱です。LLM やエージェントによって生成される SQL クエリは、パフォーマンスのボトルネック、予測できないコスト、および一貫性のない結果を引き起こす可能性があります。

操作データ製品に移行することで、変動性を排除し、各ツールが以下の特性を備えることを保証します。

• 安定性: 一度定義すれば繰り返し使用でき、一貫したビジネスロジックを保証します。
• 型付け: 入力と出力のスキーマはインデックスから派生します。
• 可観測性: ツールごとに使用状況を記録し、コストとパフォーマンスを明示的にします。
• 安全性: ビュー/インデックスを作成していない場合は、呼び出すことができません。

📦 インストール

このパッケージはローカルにインストールできます。ビルドツールとして uv の使用をおすすめします。

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

📚 ドキュメント

設定

ツールの定義

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