SQL MCP란?
SQL은(는) MCP server입니다. 제어된 관계 대수와 엄격한 보안 정책을 통해 AI agent가 PostgreSQL, MySQL, OceanBase에 액세스할 수 있도록 관리형 SQL 게이트웨이를 제공합니다.
프로젝트 README에서 생성된 요약
SQL MCP server 정보
신뢰할 수 없는 AI agent가 관계형 데이터베이스와 상호작용할 수 있도록 관리형 게이트웨이를 제공하는 것이 이 server의 주요 기능입니다. 개발자는 Claude Desktop, Cursor 또는 VS Code와 같은 AI 클라이언트를 PostgreSQL, MySQL, OceanBase 인스턴스에 연결할 수 있습니다. 임의의 SQL을 허용하는 대신, 시스템은 관계 대수와 매개변수화된 코드 생성을 사용하여 agent가 화이트리스트에 등록된 제어된 도구를 통해서만 결정론적 작업을 수행하도록 보장합니다.
보안은 필드 수준 ACL, 행 정책 및 마스킹을 통해 강화되어 승인되지 않은 데이터 노출을 방지합니다. 신뢰할 수 있는 운영자의 경우, 명시적인 권한을 통해 특정 execute_sql 탈출 채널을 활성화할 수 있지만 기본적으로는 비활성화 상태로 유지됩니다. 이 server는 EXPLAIN 사전 검사, 결과 제한, 타임아웃 및 세션 예산을 사용하여 비용과 성능을 관리합니다. 배포는 Docker Compose 또는 Go를 사용한 수동 빌드를 통해 이루어지며, 관리자는 전용 웹 콘솔을 통해 설정을 관리할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SQL MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SQL MCP 설치
$ claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Cursor에 SQL MCP 설치
~/.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>"
}
}
}
}VS Code에 SQL MCP 설치
.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>"
}
}
}
}VS Code CLI에 SQL MCP 설치
$ 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>"}}'Claude Desktop에 SQL MCP 설치
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>"
}
}
}
}Codex에 SQL MCP 설치
$ codex mcp add sql-mcp-server --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Codex config.toml에 SQL MCP 설치
~/.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>"
Gemini CLI에 SQL MCP 설치
$ 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.21Gemini settings.json에 SQL MCP 설치
~/.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>"
}
}
}
}구성
DATABASE_DSN비밀Database DSN referenced by ${DATABASE_DSN} in config.yaml
| 이름 | 설명 | 유형 |
|---|---|---|
| DATABASE_DSN | Database DSN referenced by ${DATABASE_DSN} in config.yaml | 비밀 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능nethinwei/sql-mcp-server is public and reachablegithub.com/nethinwei/sql-mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-21github.com/nethinwei/sql-mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
SQL MCP를 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.21를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SQL MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
지원되는 데이터베이스는 무엇인가요?
이 server는 PostgreSQL, MySQL, OceanBase를 지원합니다.
신뢰할 수 있는 운영자가 원시 SQL을 실행하려면 어떻게 해야 하나요?
신뢰할 수 있는 운영자는 execute_sql이라는 별도의 SQL 탈출 채널을 사용할 수 있습니다. 이 기능은 기본적으로 비활성화되어 있으며 명시적인 권한이 필요합니다.
데이터 액세스를 위한 보안 조치에는 어떤 것들이 있나요?
이 server는 RBAC, 필드 ACL, 행 정책 및 마스킹을 적용합니다.