SQL MCP server
Commit 21 Okt 2026Menyediakan gateway SQL yang terkelola bagi AI agent untuk mengakses PostgreSQL, MySQL, dan OceanBase melalui aljabar relasional yang terkontrol dan kebijakan keamanan yang ketat.
Juga dikenal sebagai nethinwei/sql-mcp-server, sql-mcp-server
- Stars
- 1
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.21
- Commit terakhir
- 21 Okt 2026
- Lisensi
- MIT
Apa itu SQL MCP?
SQL adalah MCP server. Menyediakan gateway SQL yang terkelola bagi AI agent untuk mengakses PostgreSQL, MySQL, dan OceanBase melalui aljabar relasional yang terkontrol dan kebijakan keamanan yang ketat.
Ringkasan dibuat dari README proyek
Tentang SQL MCP server
Fungsi utama dari server ini adalah menyediakan gateway yang terkelola agar AI agent yang tidak terpercaya dapat berinteraksi dengan database relasional. Server ini memungkinkan developer untuk menghubungkan AI client seperti Claude Desktop, Cursor, atau VS Code ke instance PostgreSQL, MySQL, dan OceanBase. Alih-alih mengizinkan SQL sembarangan, sistem ini menggunakan aljabar relasional dan pembuatan kode berparameter untuk memastikan bahwa agent hanya melakukan operasi deterministik melalui whitelist tool yang terkontrol.
Keamanan ditegakkan melalui field-level ACLs, row policies, dan masking untuk mencegah paparan data yang tidak sah. Bagi operator terpercaya, channel escape execute_sql tertentu dapat diaktifkan melalui izin eksplisit, meskipun secara default tetap dinonaktifkan. Server ini mengelola biaya dan performa dengan menggunakan EXPLAIN pre-screening, limit hasil, timeout, dan budget sesi. Deployment dapat dilakukan melalui Docker Compose atau build manual menggunakan Go, dan administrator dapat mengelola konfigurasi melalui web console khusus.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal SQL MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal SQL MCP di Claude Code
$ claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Instal SQL MCP di Cursor
~/.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>"
}
}
}
}Instal SQL MCP di VS Code
.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>"
}
}
}
}Instal SQL MCP di VS Code CLI
$ 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>"}}'Instal SQL MCP di Claude Desktop
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>"
}
}
}
}Instal SQL MCP di Codex
$ codex mcp add sql-mcp-server --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Instal SQL MCP di Codex config.toml
~/.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>"
Instal SQL MCP di Gemini CLI
$ 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.21Instal SQL MCP di Gemini settings.json
~/.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>"
}
}
}
}Konfigurasi
DATABASE_DSNRahasiaDatabase DSN referenced by ${DATABASE_DSN} in config.yaml
| Nama | Deskripsi | Tipe |
|---|---|---|
| DATABASE_DSN | Database DSN referenced by ${DATABASE_DSN} in config.yaml | Rahasia |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaunethinwei/sql-mcp-server is public and reachablegithub.com/nethinwei/sql-mcp-server ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-21github.com/nethinwei/sql-mcp-server ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubSQL 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。
许可
Pertanyaan tentang SQL MCP
Bagaimana cara menambahkan SQL MCP ke Claude Code?
Jalankan 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 di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan SQL MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Database apa saja yang didukung?
Server ini mendukung PostgreSQL, MySQL, dan OceanBase.
Bagaimana operator terpercaya dapat mengeksekusi raw SQL?
Operator terpercaya dapat menggunakan channel escape SQL terpisah bernama execute_sql, yang secara default dinonaktifkan dan memerlukan izin eksplisit.
Langkah keamanan apa yang diterapkan untuk akses data?
Server ini menerapkan RBAC, field ACLs, row policies, dan masking.