Sql MCP

🚀 SQL MCP 服务器

SQL MCP 服务器 是一个统一的代理接口，它允许 AI 模型（如 Claude）通过一套单一、标准化的工具来检查、查询和与多种类型的数据库进行交互。

无需为 MySQL、SQL Server、Oracle 等分别安装和配置服务器，这个单一的软件包可以根据你的配置动态加载正确的“适配器”，从而处理所有这些数据库。

🚀 快速开始

SQL MCP 服务器提供了一个统一的方式让 AI 模型与多种数据库交互。你可以通过克隆仓库、创建虚拟环境、安装依赖以及配置环境变量来启动使用。

✨ 主要特性

• 标准化工具集：无论 AI 是与 Oracle 还是 MySQL 进行交互，它始终使用相同的工具（execute_query、describe_table、get_db_version）。这减少了错误信息的产生，并提高了查询的准确性。
• 资源管理：自动将数据库表作为 MCP 资源公开，便于检查。
• 智能适配器：
  • ✅ MySQL：使用 mysql-connector-python 并支持连接池。
  • ✅ MSSQL：使用 pymssql 并自动检测模式名称（例如 dbo.Users）。
  • ✅ Sybase / SAP IQ：使用 pyodbc 并智能处理 dba. 前缀和服务器名称。
  • ✅ Oracle：使用 oracledb（瘦模式），无需复杂的驱动程序安装即可轻松连接。
• 支持 Unicode：所有连接默认使用 UTF - 8 编码，可无缝处理特殊字符。

📦 安装指南

1. 克隆仓库：

   git clone https://github.com/BryR0/sql-mcp.git
   cd sql-mcp
   

2. 创建虚拟环境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：.\venv\Scripts\activate
   

3. 安装依赖：

   pip install -e .
   

📚 详细文档

⚙️ 配置

你可以通过 DB_TYPE 环境变量来指定要使用的数据库。

支持的环境变量

Claude 桌面配置示例

将以下内容添加到你的 claude_desktop_config.json 中。请注意，DB_PORT 是可选的，如果省略，将默认为所选数据库类型的标准端口。

{
  "mcpServers": {
    "sql_mcp_mysql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mysql",
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "my_db"
      }
    },
    "sql_mcp_mssql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mssql",
        "DB_HOST": "192.168.1.50",
        "DB_USER": "sa",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "DataWarehouse"
      }
    }
  }
}

🏗️ 架构

该项目使用 适配器模式：

1. 服务器 接收请求（例如 execute_query）。
2. 工厂 检查 DB_TYPE 并实例化正确的类（例如 MSSQLAdapter）。
3. 适配器 将通用请求转换为特定驱动程序调用（pymssql、pyodbc 等）。
4. 响应 被格式化为标准的 JSON 结构供 AI 使用。

这意味着你只需更改配置，而无需更改 AI 的提示或逻辑，就可以切换数据库。

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。