SQL MCP sunucusu
Commit 21 Eki 2026Yapay zeka ajanlarının PostgreSQL, MySQL ve OceanBase veritabanlarına kontrollü ilişkisel cebir ve katı güvenlik politikaları aracılığıyla erişebilmesi için yönetilen bir SQL gateway sağlar.
Ayrıca bilinen adı nethinwei/sql-mcp-server, sql-mcp-server
- Yıldızlar
- 1
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.21
- Son commit
- 21 Eki 2026
- Lisans
- MIT
SQL MCP nedir?
SQL bir MCP sunucusudur. Yapay zeka ajanlarının PostgreSQL, MySQL ve OceanBase veritabanlarına kontrollü ilişkisel cebir ve katı güvenlik politikaları aracılığıyla erişebilmesi için yönetilen bir SQL gateway sağlar.
Özet, projenin README dosyasından oluşturuldu
SQL MCP sunucusu hakkında
Bu sunucunun temel işlevi, güvenilmeyen yapay zeka ajanlarının ilişkisel veritabanlarıyla etkileşime girmesi için yönetilen bir gateway sağlamaktır. Geliştiricilerin Claude Desktop, Cursor veya VS Code gibi yapay zeka istemcilerini PostgreSQL, MySQL ve OceanBase örneklerine bağlamasına olanak tanır. Sistem, rastgele SQL komutlarına izin vermek yerine, ajanların yalnızca kontrollü araçlar listesi üzerinden deterministik işlemler gerçekleştirmesini sağlamak için ilişkisel cebir ve parametreli kod üretimi kullanır.
Güvenlik; yetkisiz veri ifşasını önleyen alan düzeyinde ACL'ler, satır politikaları ve maskeleme yoluyla sağlanır. Güvenilir operatörler için, varsayılan olarak devre dışı bırakılmış olsa da, açık izinler aracılığıyla özel bir execute_sql kaçış kanalı etkinleştirilebilir. Sunucu; EXPLAIN ön incelemesi, sonuç limitleri, zaman aşımı süreleri ve oturum bütçeleri kullanarak maliyetleri ve performansı yönetir. Dağıtım, Docker Compose veya Go kullanılarak yapılan manuel kurulumlarla gerçekleştirilebilir ve yöneticiler yapılandırmaları özel bir web konsolu üzerinden yönetebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
SQL MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleSQL MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21SQL MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}SQL MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"sql-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}SQL MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"sql-mcp-server","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/nethinwei/sql-mcp-server:0.1.21"],"env":{"DATABASE_DSN":"<YOUR_DATABASE_DSN>"}}'SQL MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}SQL MCP'yi Codex içine yükleyin
$ codex mcp add sql-mcp-server --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21SQL MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.sql-mcp-server] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/nethinwei/sql-mcp-server:0.1.21"] [mcp_servers.sql-mcp-server.env] DATABASE_DSN = "<YOUR_DATABASE_DSN>"
SQL MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server docker -- run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21SQL MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}Yapılandırma
DATABASE_DSNGizliDatabase DSN referenced by ${DATABASE_DSN} in config.yaml
| Ad | Açıklama | Sunucu |
|---|---|---|
| DATABASE_DSN | Database DSN referenced by ${DATABASE_DSN} in config.yaml | Gizli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirnethinwei/sql-mcp-server is public and reachablegithub.com/nethinwei/sql-mcp-server ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-21github.com/nethinwei/sql-mcp-server ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
SQL MCP Server
The governed SQL gateway for untrusted AI agents.
面向不可信 AI Agent 的受控 SQL 数据访问网关。通过显式 Entity、关系代数 IR 和
参数化 codegen 访问 PostgreSQL、MySQL 与 OceanBase,受治理面不接受任意 SQL,不提供
DDL。可信操作者另有独立的 SQL 逃生通道 execute_sql:默认关闭,只对被显式授予
sql:execute@<数据源> 的用户可见,走单独声明的连接,受硬上限与写入失败即拒绝的
审计约束(见安全模型)。
核心差异
- 确定性执行: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.26.10+ 和一个已验证数据库版本:
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、启动、热重载、容器部署和升级:运行与运维;
- Web 管理控制台与 Docker Compose 部署:管理控制台;
- 魔搭分发展示:ModelScope 上架与使用。
按角色阅读
首次体验与集成
- 五分钟快速体验:唯一完整 Demo 与 Inspector 示例;
- 配置参考:公开 YAML 配置的唯一事实源;
- Provider 兼容性与 支持版本:当前能力和验证边界。
部署与安全
- 运行与运维:CLI、容器部署、生命周期、监控和升级;
- 管理控制台:配置编辑、发布回滚、管理员权限与 Docker 部署;
- 安全模型:运行时安全行为的唯一事实源;
- 威胁模型:威胁、控制、测试证据与剩余风险;
- SECURITY.md:漏洞披露流程。
开发与维护
版本与规划
- 当前 GA:
v0.1.21(发布说明); - 全版本摘要:CHANGELOG;历史能力与迁移: 发布说明索引;
- 未发布产品规划:Roadmap;
- 数据库候选:Provider Roadmap。
许可
SQL MCP soruları
SQL MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
SQL MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hangi veritabanları destekleniyor?
Sunucu PostgreSQL, MySQL ve OceanBase desteklemektedir.
Güvenilir bir operatör ham SQL nasıl çalıştırabilir?
Güvenilir operatörler, varsayılan olarak devre dışı bırakılan ve açık izin gerektiren execute_sql adlı ayrı bir SQL kaçış kanalı kullanabilirler.
Veri erişimi için hangi güvenlik önlemleri uygulanıyor?
Sunucu; RBAC, alan bazlı ACL'ler, satır politikaları ve maskeleme yöntemlerini uygular.