English Français العربية

SQL MCP Server

السجل الرسمي البيانات وقواعدها

Controlled SQL access gateway with policy, cost limits, tenant isolation, and safe tools.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package ghcr.io/nethinwei/sql-mcp-server:0.1.21
Claude Code 
claude mcp add sql-mcp-server -e 'DATABASE_DSN=<your database_dsn>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 serve --config /config/config.yaml --transport stdio
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "sql-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/nethinwei/sql-mcp-server:0.1.21",
                "serve",
                "--config",
                "/config/config.yaml",
                "--transport",
                "stdio"
            ],
            "env": {
                "DATABASE_DSN": "<your database_dsn>"
            }
        }
    }
}

متغيرات البيئة

  • DATABASE_DSN سري Database DSN referenced by ${DATABASE_DSN} in config.yaml

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SQL MCP Server
  2. 核心差异
  3. 五分钟体验
  4. 安装与接入
  5. 按角色阅读
  6. 许可

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

按角色阅读

首次体验与集成
部署与安全
开发与维护
版本与规划

许可

MIT

الأسئلة الشائعة

ما هو SQL MCP Server؟

Controlled SQL access gateway with policy, cost limits, tenant isolation, and safe tools.

كيف أثبّت SQL MCP Server؟

يعمل على جهازك. في Claude Code: claude mcp add sql-mcp-server -e 'DATABASE_DSN=<your database_dsn>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 serve --config /config/config.yaml --transport stdio. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SQL MCP Server إلى مفتاح API؟

نعم. يتطلب DATABASE_DSN، وتضبطها في إعداداته.

هل SQL MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون SQL MCP Server؟

ينشره nethinwei. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.