MCP Sql

🚀 mcp-sql

mcp-sql 是一个 MCP 服务器，它允许大语言模型（LLMs）查询 PostgreSQL、SQLite 和 MySQL 数据库。它是单二进制文件，默认只读，支持多数据库。

🚀 快速开始

你可以按照以下步骤快速使用 mcp-sql。

📦 安装指南

使用以下命令安装 mcp-sql：

cargo install mcp-sql

💻 使用示例

基础用法

# 演示模式 — 使用示例数据立即尝试
mcp-sql --demo

# 单个数据库
mcp-sql --url postgres://user:pass@localhost/mydb

# SQLite
mcp-sql --url sqlite:path/to/db.sqlite

# 多个数据库
mcp-sql --url postgres://localhost/app --url sqlite:analytics.db

# 启用写操作
mcp-sql --url sqlite:local.db --allow-write

# 自定义行限制
mcp-sql --url mysql://user:pass@localhost/shop --row-limit 500

# 从环境变量中读取 URL
mcp-sql --url-env DATABASE_URL

# 混合使用 --url 和 --url-env
mcp-sql --url sqlite:local.db --url-env PROD_DB_URL

# 自定义查询超时时间（默认：30 秒）
mcp-sql --url sqlite:local.db --query-timeout 60

📚 详细文档

Claude Code 配置

claude mcp add sql -- mcp-sql --url sqlite:path/to/your.db

或者直接编辑 ~/.claude.json：

{
  "mcpServers": {
    "sql": {
      "type": "stdio",
      "command": "mcp-sql",
      "args": ["--url", "sqlite:path/to/your.db"]
    }
  }
}

Claude Desktop 配置

在你的 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "sql": {
      "command": "mcp-sql",
      "args": [
        "--url", "postgres://user:pass@localhost/mydb",
        "--url", "sqlite:analytics.db"
      ]
    }
  }
}

Cursor / VS Code 配置

在你的 MCP 配置文件（.cursor/mcp.json 或等效文件）中添加以下内容：

{
  "mcpServers": {
    "sql": {
      "command": "mcp-sql",
      "args": ["--url", "sqlite:path/to/your.db"]
    }
  }
}

工具介绍

当连接多个数据库时，所有工具都接受一个可选的 database 参数。如果只连接了一个数据库，则会自动使用该数据库。

CLI 选项

至少需要一个 --url 或 --url-env（除非使用 --demo）。

🔧 技术细节

安全性

• 默认只读 — 只允许 SELECT、WITH、SHOW、PRAGMA 和 EXPLAIN 查询。
• 强制行限制 — 如果查询中没有 LIMIT，则会自动注入（默认：100）。
• 查询超时 — 查询在配置的超时时间后会被终止（默认：30 秒）。
• 凭证隐藏 — 在 list_databases 输出中，密码会被屏蔽。
• PostgreSQL/MySQL — 此外，还使用 SET TRANSACTION READ ONLY 进行数据库级别的强制限制。

使用 --allow-write 可启用 INSERT、UPDATE、DELETE、CREATE 和 DROP 操作。

支持的数据库

📄 许可证

你可以选择遵循 Apache 许可证 2.0 版 或 MIT 许可证。