sql-mcp-server
A governed SQL gateway for untrusted AI agents, providing controlled access to PostgreSQL, MySQL, and OceanBase with RBAC, field ACLs, row policies, and cost controls.
README
SQL MCP Server
The governed SQL gateway for untrusted AI agents.
面向不可信 AI Agent 的受控 SQL 数据访问网关。通过显式 Entity、关系代数 IR 和 参数化 codegen 访问 PostgreSQL、MySQL 与 OceanBase，不接受任意 SQL，不提供 DDL。
核心差异
- 确定性执行：Agent 只能组合受控工具和白名单 IR；
- 字段与行治理：RBAC、字段 ACL、row policy 和 mask 统一强制；
- 成本可控：EXPLAIN 预筛、结果上限、超时和 session/tenant 预算；
- 默认拒绝：安全能力无法证明时 fail closed；
- 可审计：配置热重载、异步审计和 OpenTelemetry hook。
运行时安全行为以安全模型为准；Provider 验证边界与证据层级 以兼容矩阵为准；威胁、控制与剩余风险见 威胁模型。所有对外声明的证据汇总见 架构、安全边界与证据索引。不以本页摘要为准。
五分钟体验
只需 Docker 与 Docker Compose：
docker compose -f examples/quickstart/compose.yaml up -d --wait
curl -fsS http://127.0.0.1:8080/healthz
完整的 MCP Inspector 调用、tenant 隔离、mask 和拒绝场景见 五分钟快速体验。
安装与接入
源码构建要求 Go 1.25.12+ 和一个已验证数据库版本：
git clone https://github.com/nethinwei/sql-mcp-server.git
cd sql-mcp-server
make build
- Cursor、Claude Desktop 和 VS Code 的 stdio 模板：
examples/clients/（核对结论见 客户端接入核对）； - 完整配置模板：
examples/config.example.yaml； - CLI、启动、热重载和升级：运行与运维；
- 魔搭分发展示：ModelScope 上架与使用。
按角色阅读
首次体验与集成
- 五分钟快速体验：唯一完整 Demo 与 Inspector 示例；
- 配置参考：公开 YAML 配置的唯一事实源；
- Provider 兼容性与 支持版本：当前能力和验证边界。
部署与安全
- 运行与运维：CLI、生命周期、监控和升级；
- 安全模型：运行时安全行为的唯一事实源；
- 威胁模型：威胁、控制、测试证据与剩余风险；
- SECURITY.md：漏洞披露流程。
开发与维护
版本与规划
- 当前 GA：
v0.1.10（发布说明）； - 全版本摘要：CHANGELOG；历史能力与迁移： 发布说明索引；
- 未发布产品规划：Roadmap；
- 数据库候选：Provider Roadmap。
许可
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.