AgentSQL

io.github.cuipengdba由 GitHub 帳號 cuipengdba 發布v0.4.0更新於 Oct 24, 2026

Guard AI agents' PostgreSQL/MySQL access via MCP: SQL audit, auth, masking, write approval

已驗證Streamable HTTP可網頁執行資料庫安全與監控

概覽

AI 產生的概覽

AgentSQL 是資料庫安全閘道類 MCP 伺服器，讓 AI 助理在授權、稽核與去識別化約束下對 PostgreSQL/MySQL 資料來源執行受控 SQL 查詢。

可以做什麼
  • 在目前身分與權限下，對已綁定的 PostgreSQL/MySQL 資料來源執行受控 SQL 查詢
  • 核對自然語言問數所產生的 SQL、結果與稽核紀錄
  • 透過結果去識別化、寫入審批與持久稽核來約束 Agent 的資料庫存取
  • 重新開啟歷史與 CSV/XLSX 匯出時逐次複核授權，權限變更後拒絕舊內容
  • 可作為獨立 MCP 閘道與 AgentSQL 自有問數頁面並用，共用身分與稽核
適用情境
希望讓外部 AI Agent 查詢業務資料庫，但不想直接交出資料庫憑證，並需要逐次授權、去識別化與稽核留痕時適用。也適合員工以自然語言問數、外部 Agent 在另行授權下查詢同一批資料來源的情境。
執行需求
遠端 Streamable HTTP 端點；公網 Demo（demo.agentsql.cn）需要在 Authorization 標頭提供 bearer 權杖。Demo 金鑰為唯讀，使用每日重置的合成資料。正式使用需透過 Docker 或原生套件自架，並設定安裝器產生的管理員密碼與資料來源綁定。
安裝前請注意
Authorization 標頭中的 bearer 權杖屬於憑證，勿寫入日誌或公開 Issue。公網 Demo 僅為模擬展示，使用合成資料，並非真實業務資料。專案聲明 v4.12.0 未在使用者真實業務系統驗證，不宣稱完全相容。自然語言結果需核對產生的 SQL 與業務含義。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AgentSQL，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.cuipengdba%2Fagentsql/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agentsql": {
      "type": "http",
      "url": "https://demo.agentsql.cn/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

AgentSQL（智盾）

语言 / Language: 简体中文 | English

[AgentSQL]

[Version v4.12.0] [Go] [License: Apache-2.0]

AgentSQL = 独立 AI 问数 Agent + MCP Server 数据库安全网关。 用户可直接在 AgentSQL 自有页面用自然语言问数；其他 AI Agent 可把 AgentSQL 当作独立 MCP Server 使用。两条入口共用当前身份与授权、受控 SQL 执行、结果脱敏和持久审计。AgentSQL 自有问数不依赖 SQLBot；SQLBot 是可经固定版本适配器接入的可选客户端。

官网 · 中文问数界面与功能示意 · v4.12.0 下载与发布边界 · 三种使用方式 · 文档索引

选一种使用方式

方式你来做什么从哪里开始
独立问数登录 AgentSQL 自有页面，选择已绑定数据源，提问并核对生成的 SQL、结果和审计问数操作与配置
独立 MCP 安全网关给外部 AI Agent 配置 Agent API Key，让 MCP 工具在授权范围内查询MCP Server 操作
两者一起员工用 AgentSQL 页面问数，外部 Agent 通过 MCP 查询；分别授权，共用安全审计联合使用
text
AgentSQL 自有页面 → Go 问数 Agent ─────┐                                    ├→ AgentSQL 安全网关 → 当前受权数据库外部 AI Agent → AgentSQL MCP Server ─┘

v4.12.0 能力与边界

能力当前状态关键边界
自有 AI 问数限定路径已验自有 Go/Web 问数；本地模型、运营方登记的 PostgreSQL 网关别名和当前权限，无需 SQLBot 运行
受权向量预热与问数按当前授权准备结构固定 ONNX 表向量支持后台预热与热索引复用；权限变化后重新核对，模型和数据库的实际环境与耗时见本版发布说明
历史与文件导出当前授权逐次复核历史重开与 CSV/XLSX 下载都重新校验授权并留审计；权限变化、会话删除或服务故障时拒绝旧内容，页面忽略迟到响应
私有数据源绑定轮换限定路径已验运维侧先建立新网关绑定并预检受权结构，再以旧绑定 ID 和存储修订比较提交；浏览器不能更换目标或凭据
MCP Server 安全网关可独立使用stdio、Streamable HTTP 和独立无状态 HTTP；Agent Key 不等于管理员令牌，每次请求按当前授权执行
基本助手与 Type 4 页面嵌入限定路径已验单数据源基本游客助手与指定页面嵌入，来源、身份及撤权仍受控
SQLBot 接入可选固定基线已验适配器可把指定 SQLBot 执行路径交给 AgentSQL MCP；不承诺任意部署零改动接入
Type 1 高级助手沿用历史限定范围运营方登记第三方目录并映射到当前受权网关别名；本版未扩大该入口的支持声明
活动数据权限限定形态已验明确列出的同工作空间用户；内建管理员/普通成员角色限定；非空白名单只作元数据，不豁免行列限制
更广兼容部分只读载入；其余未验证原版社区管理页列表可加载不等于创建、编辑、导入导出已验；云模型真实推理、任意角色扩展及原版权限库直接迁移仍未验证

自然语言结果需要核对生成的 SQL 和业务含义。v4.12.0 未在用户真实业务系统验证，不宣称 100% 兼容或零改动切换；正式发布说明给出精确提交、验收场景、性能数字与限制。固定 25 场景评分合同严格通过 6/25（24%），本版逐项验收列明证据与未测项，未完成合同的场景计零；这不等于 AgentSQL 独立 MCP 安全网关的能力覆盖率。公网 Demo 的问数模型仅作模拟展示。

快速开始

Linux amd64 / arm64 原生包要求 glibc ≥ 2.28 和 PID 1 的 systemd。下载正式包后先按发布说明核对签名和哈希。以下命令安装网关；自有问数需要按三种使用方式安装问数组件并配置本地文本模型与个人数据源绑定。

bash
curl -fsSL https://github.com/cuipengdba/agentsql/releases/download/v4.12.0/install.sh | sudo sh -s -- install --version v4.12.0

Docker 使用多架构正式镜像；一键脚本仅绑定本机回环地址并创建持久卷：

bash
curl -fsSL https://raw.githubusercontent.com/cuipengdba/agentsql/v4.12.0/scripts/quickstart.sh -o quickstart.sh && sh quickstart.sh --version v4.12.0

网关控制台默认 http://127.0.0.1:7780，安装了问数组件后自有页面默认 http://127.0.0.1:8000。安装器生成持久管理员密码；非交互日志不输出，可由 root 在 /etc/agentsql/agentsql.env 查看。远程访问应使用 SSH 本地转发或受控 HTTPS 反向代理，不直接暴露管理端口。离线安装、密钥、备份和升级步骤见部署指南。

按任务查文档

任务文档
三种产品形态与验收步骤三种使用方式
自有问数模型与个人绑定原生问数配置
MCP 客户端、协议与工具MCP 接入指南
控制台权限、规则、脱敏与审计使用手册 · 安全边界
SQLBot 固定版本适配SQLBot 接入 · Type 1 高级助手部署
数据库适配分级与证据官网兼容矩阵 · 数据库研究与验收
离线安装、升级、备份与恢复部署指南 · 运维手册

数据库“已注册”“连接级”“指定版本受控只读”“指定场景完整防护”是不同等级。官网矩阵保留逐库版本、拓扑与验收边界；连接成功不等于可安全问数，也不等于厂商认证。

社区与项目

历史 Release · CHANGELOG · 路线图 · Issues · Discussions · 贡献指南

当前源码按 Apache-2.0 发布，并附 NOTICE；AgentSQL 名称和标识的商标权不由该许可证授予。未修复漏洞请按 SECURITY.md 私下报告，不在公开 Issue 中提交真实凭据或连接串。

來源：README.md，提交 bd11b0b

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v0.4.0最新Sep 30, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分