跳至主要內容
hs-sql-agent

開源 SQL-to-MCP Tool Factory · 六種 SQL 方言 · fail-closed

把可信 SQL 直接發布成受治理的 AI MCP 工具

在管理介面定義參數化 SQL,發布成 typed MCP tool,AI 只需要填參數。每次執行仍會經過 hs-sql-agent 的 fail-closed compiler、存取政策與 Safe DML 控制。

get_customer_orders
SELECT id, total, status
FROM orders
WHERE customer_id = {{ customerId }}
customerId: number → typed MCP argument

SQL → MCP

不用寫 MCP Server 程式碼,也能發布 AI Tool。

設定 Tool 名稱與給模型看的描述、貼上 SQL Template、宣告 {{ customerId }} 這類參數、測試後發布;系統會依參數契約產生 MCP schema。

01 寫 SQL
02 宣告參數
03 測試並發布
04 Agent 呼叫 Tool

GOVERNANCE

SQL 形狀可控,執行仍受治理。

Custom Tool 不會繞過安全邊界。Query 走同一套 typed compiler 與 table policy;DML 走同一套 preview、approval、revalidation 與 transaction。

SIX DATABASES

PostgreSQL · MySQL · SQL Server · Oracle · SQLite · Firebird

One governed tool contract across six supported database providers, with provider-aware validation and lowering.

TWO MODES

hs-sql-agent 有兩種使用方式

Custom SQL Tools 需要可預測、工程師定義好的行為時,把可信 SQL 發布成可重用 MCP Tool。
Raw SQL Tools 真的需要臨時查詢時,仍可保留 raw SQL tools 給 Agent 使用。