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 分