hs-sql-agent

快速部署一个内置管理面板的 关系型数据库 HTTP MCP 服务器。 hs-sql-agent 允许 Claude Desktop、Cursor、Visual Studio Code 等 MCP 客户端安全访问关系型数据库，同时让管理员集中管理数据库连接、MCP 密钥、权限、审计日志以及安全策略。 此 Zeabur 模板会自动部署：

• hs-sql-agent — MCP 服务器及管理面板
• PostgreSQL — 内部管理数据库
• Redis — 缓存、速率限制、并发控制以及安全策略同步

✨ 功能特性

• 🔌 HTTP MCP 端点
• 🔑 每个客户端独立的 MCP 访问密钥
• 🗄️ 多数据库连接管理
• 🔐 每个 MCP 密钥独立绑定数据库
• 🧰 每个 MCP 密钥独立配置工具权限
• 🚦 可配置速率限制
• 📋 SQL 执行审计日志
• 🛡️ 集中式安全策略
• ⚡ 基于 Redis 的缓存与并发控制
• 🖥️ 内置 Web 管理面板
• 📋 可直接复制的 MCP 客户端配置

🚀 快速开始

1. 部署模板

在 Zeabur 中部署此模板，并为管理面板设置一个子域名。 Zeabur 会自动创建并连接所有必需的服务。 部署完成后，打开 Zeabur 部署说明中显示的 Admin Panel URL。

2. 创建管理员账户

首次启动时，需要创建第一个管理员账户。 创建完成后，使用该账户登录管理面板。

3. 添加数据库

进入 DB Management，添加希望 MCP 客户端访问的关系型数据库。 建议在签发 MCP 密钥之前先测试数据库连接。

4. 签发 MCP 访问密钥

进入： Runtime Admin → MCP Keys 创建新的 MCP 密钥，并配置对应的访问权限。 可配置项目包括：

• 密钥名称
• 过期时间
• 数据库
• 速率限制
• 允许使用的 MCP 工具
• 可选的数据访问限制
• 可选的 CORS Origins 点击 Test DB Connection 验证所选数据库连接，然后点击 Issue Key。

5. 复制 MCP 配置

密钥签发成功后，hs-sql-agent 会立即显示 Save and connect 对话框。 其中包含：

• 仅显示一次的 MCP 密钥 * MCP 端点 * 已生成好的 MCP 客户端配置 选择你使用的客户端：
• Claude Desktop
• Cursor
• Visual Studio Code
• Generic HTTP 然后点击对应的 Copy config 按钮，将配置直接粘贴到 MCP 客户端中即可。

⚠️ MCP 密钥的明文值只会显示一次。 > > 请在关闭对话框之前保存密钥，或者复制生成好的客户端配置。关闭后，无法再从 Admin UI 查看该密钥的明文值。 完成。无需手动填写 MCP 端点或认证 Header。

🔐 安全建议

请将 MCP 密钥视为密码等敏感信息。 不要将包含 MCP 密钥的配置提交到源代码仓库，也不要粘贴到公开 Issue、工单或其他公开位置。 如果密钥意外泄露，请前往 MCP Keys 页面撤销该密钥，并重新签发一个新的密钥。 对于生产环境数据库，建议使用专用数据库账户，并遵循最小权限原则，仅授予实际 MCP 工具所需的权限。

⚠️ 项目状态

hs-sql-agent 当前仍处于 积极开发阶段。 不同版本之间的功能和配置可能发生变化，也可能仍存在 Bug。 如果遇到问题或希望提出功能建议：

• 🔗 GitHub Issues
• ⭐ GitHub Repository