Back to Browse

Agentsql MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://demo.agentsql.cn/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

database

Applies to the server that hosts this plugin, not to your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

AGENTSQL_SECRETRequired
AGENTSQL_ADMIN_USERRequired
AGENTSQL_ADMIN_PASSWORDRequired

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-cuipengdba-agentsql": {
      "url": "https://demo.agentsql.cn/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

AgentSQL(智盾)

语言 / Language: 简体中文 | English

Version v4.6.0 Go License: Apache-2.0

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

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

选一种使用方式

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

v4.6.0 能力与边界

能力当前状态关键边界
自有 AI 问数限定路径已验自有 Go/Web 问数;本地模型、运营方登记的 PostgreSQL 网关别名和当前权限,无需 SQLBot 运行
MCP Server 安全网关可独立使用stdio、Streamable HTTP 和独立无状态 HTTP;Agent Key 不等于管理员令牌,每次请求按当前授权执行
基本助手与 Type 4 页面嵌入限定路径已验单数据源基本游客助手与指定页面嵌入,来源、身份及撤权仍受控
SQLBot 接入可选固定基线已验适配器可把指定 SQLBot 执行路径交给 AgentSQL MCP;不承诺任意部署零改动接入
Type 1 高级助手限定路径已验未修改 SQLBot Community v1.10.3 助手 SDK;运营方登记第三方目录,将外部 ID 映射到当前受权的网关别名,独立助手监听器不提供管理 API;只支持发布说明列明的场景
更广兼容后续规划复杂活动权限规则与其余社区版页面/API 分别规划至 v4.7.0 和 v4.8.0

自然语言结果需要核对生成的 SQL 和业务含义。v4.6.0 未在用户真实业务系统验证,不宣称 100% 兼容或零改动切换;正式发布说明给出精确提交、验收场景、性能数字与限制。公网 Demo 的问数模型仅作模拟展示。

快速开始

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

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

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

curl -fsSL https://raw.githubusercontent.com/cuipengdba/agentsql/v4.6.0/scripts/quickstart.sh -o quickstart.sh && sh quickstart.sh --version v4.6.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 中提交真实凭据或连接串。

Reviews

No reviews yet

Be the first to review this server!