数据库 Schema MCP 服务器

一个强大的 MCP 服务器，提供从各种数据库类型（PostgreSQL、MySQL、SQLite 等）读取和暴露数据库 Schema 的工具。

🌟 功能特性

• 连接到不同类型的数据库
• 列出数据库中的所有表
• 获取特定表的详细 Schema 信息
• 获取完整的数据库 Schema，包括表、视图和索引
• 支持多种数据库类型（PostgreSQL、MySQL、SQLite）

🚀 安装

前提条件

1. Python 3.x
2. 虚拟环境（推荐）

基本安装

1. 创建并激活虚拟环境：

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# 在 Unix/macOS 上：
source venv/bin/activate
# 在 Windows 上：
venv\Scripts\activate

2. 安装依赖：

pip install -r requirements.txt

Windows MCP 安装

1. 安装 Node.js：

   • 从 Node.js 官方网站 下载并安装
   • 通过在 PowerShell 中运行 node --version 验证安装

2. 更新系统路径：

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

3. 如果 Node.js 未被识别，手动添加到路径：

   • 按 Windows + R
   • 输入 sysdm.cpl 并按 Enter
   • 转到“高级”选项卡
   • 点击“环境变量”
   • 在“系统变量”下，找到并选择“Path”
   • 点击“编辑”
   • 如果不存在，添加 C:\Program Files\nodejs\
   • 点击所有窗口上的“确定”
   • 重启你的电脑

4. 安装 MCP：

   • 下载 mcp-install.ps1 脚本
   • 解锁文件（右键单击 → 属性 → 解锁）
   • 以管理员身份打开 PowerShell 并运行：

     Set-ExecutionPolicy unrestricted
     

   • 导航到脚本位置并运行：

     .\mcp-install.ps1 @modelcontextprotocol/server-postgres
     

   • 完全退出 Claude Desktop（检查系统托盘）
   • 在 C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json 中配置服务器
   • 将 MCP 服务器配置复制到 Cursor 中的 mcp.json
   • 重启 Cursor

MCP 配置示例

在你的项目根目录中创建一个 .cursor/mcp.json 文件，结构如下：

{
    "mcpServers": {
        "local-db": {
            "args": [
                "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-postgres\\dist\\index.js",
                "database-url"
            ],
            "command": "node"
        },
        "staging-db": {
            "args": [
                "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-postgres\\dist\\index.js",
                "database-url"
            ],
            "command": "node"
        },
        "production-db": {
            "args": [
                "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-postgres\\dist\\index.js",
                "database-url"
            ],
            "command": "node"
        }
    }
}

将 YOUR_USERNAME 替换为你的 Windows 用户名，并确保路径与你的 Node.js 模块安装位置匹配。

💻 使用

启动服务器

python src/server.py

可用工具

1. 连接到数据库

config = {
    "type": "postgresql",  # or "mysql", "sqlite"
    "host": "localhost",
    "port": 5432,
    "database": "mydb",
    "username": "user",
    "password": "password"
}
result = await connect_database(config)

2. 列出表

tables = await list_tables("postgresql://user:password@localhost:5432/mydb")

3. 获取表 Schema

schema = await get_table_schema("postgresql://user:password@localhost:5432/mydb", "users")

4. 获取数据库 Schema

schema = await get_database_schema("postgresql://user:password@localhost:5432/mydb")

📚 与 Claude 的示例用法

# 连接到数据库
config = {
    "type": "postgresql",
    "host": "localhost",
    "port": 5432,
    "database": "mydb",
    "username": "user",
    "password": "password"
}
await connect_database(config)

# 获取完整的 Schema
schema = await get_database_schema("postgresql://user:password@localhost:5432/mydb")

# 分析 Schema
print(f"数据库有 {len(schema['tables'])} 张表")
for table_name, table_info in schema['tables'].items():
    print(f"\n表: {table_name}")
    print(f"列: {len(table_info['columns'])}")
    print(f"主键: {table_info['primary_keys']}")
    print(f"外键: {len(table_info['foreign_keys'])}")

🔒 安全最佳实践

1. 永远不要在客户端代码中暴露敏感的数据库凭据
2. 使用环境变量或安全配置管理来管理凭据
3. 实施适当的访问控制和身份验证
4. 尽可能使用 SSL/TLS 进行数据库连接