AI导哈

多数据库查询服务器

PolyQuery MCP 是一个支持多种数据库的模型上下文协议服务器，允许AI助手安全地查询和探索数据库，支持MySQL、PostgreSQL、MongoDB、Redis、Oracle和SQLite等多种数据库。

  • by Sssstardust
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Sssstardust/PolyQuery-MCP

使用说明

PolyQuery MCP

一个支持多种数据库的 MCP (Model Context Protocol) 服务器，让 AI 助手能够安全地查询和探索数据库。

支持 MySQL | PostgreSQL | MongoDB | Redis | Oracle | SQLite

✨ 特性

  • 🏢 多数据源支持 - 每种数据库可配置多个数据源
  • 📊 多业务库管理 - 支持订单库、用户库、日志库等分离
  • 🔄 读写分离 - 支持主库/从库配置
  • 🛡️ 安全只读 - 默认只读模式，防止误操作
  • 🔌 多数据库支持 - MySQL、PostgreSQL、MongoDB、Redis、Oracle、SQLite

🚀 快速开始

安装

npm install -g polyquery-mcp

配置 MCP 客户端

每个数据源独立一个环境变量，格式为 {DB_TYPE}_{name}=连接字符串：

{
  "mcpServers": {
    "polyquery": {
      "command": "polyquery-mcp",
      "env": {
        "MYSQL_primary": "mysql://user:pass@primary-host:3306/main_db",
        "MYSQL_replica": "mysql://user:pass@replica-host:3306/main_db",
        "POSTGRES_main": "postgresql://user:pass@host:5432/main_db",
        "POSTGRES_archive": "postgresql://user:pass@host:5432/archive_db",
        "MONGODB_main": "mongodb://user:pass@host:27017/main_db",
        "REDIS_cache": "redis://:pass@host:6379/0",
        "REDIS_session": "redis://:pass@host:6379/1",
        "ORACLE_main": "oracle://user:pass@host:1521/service",
        "SQLITE_main": "/path/to/main.db",
        "READ_ONLY_MODE": "true",
        "MAX_ROWS": "1000",
        "QUERY_TIMEOUT": "30000"
      }
    }
  }
}

使用 npx：

{
  "mcpServers": {
    "polyquery": {
      "command": "npx",
      "args": ["-y", "polyquery-mcp"],
      "env": {
        "MYSQL_primary": "mysql://user:pass@host:3306/db",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

📝 配置说明

配置规则

每个数据源独立一个环境变量：

{DB_TYPE}_{name}=连接字符串
  • DB_TYPE 不区分大小写，统一按小写处理
  • name 为自定义数据源名称，第一个 _ 后的全部内容均为 name（支持 _）
  • 例：MYSQL_primary、ORACLE_tob、MYSQL_order_db
数据库 示例变量名 连接字符串格式
MySQL MYSQL_primary mysql://user:pass@host:3306/db
PostgreSQL POSTGRES_main postgresql://user:pass@host:5432/db
MongoDB MONGODB_main mongodb://user:pass@host:27017/db
Redis REDIS_cache redis://:pass@host:6379/0
Oracle ORACLE_main oracle://user:pass@host:1521/service
SQLite SQLITE_main /path/to/database.db

密码中含特殊字符（$ ! # ^ 等）需 URL 编码，如 $ → %24，# → %23

安全配置

环境变量 默认值 说明
READ_ONLY_MODE true 只读模式，禁止 INSERT/UPDATE/DELETE
MAX_ROWS 1000 查询返回的最大行数
QUERY_TIMEOUT 30000 查询超时时间（毫秒）

🔧 可用工具

工具 说明
query_database 执行数据库查询
list_tables 列出所有表/集合
describe_table 获取表结构信息
test_connection 测试数据库连接
list_databases 列出已配置的数据库及数据源

工具参数说明

  • db_type: 数据库类型（mysql/postgres/mongodb/redis/oracle/sqlite）
  • connection_name: 数据源名称（可选，默认使用 default）
  • 使用 list_databases 查看可用的数据源列表

💡 使用示例

查看已配置的数据源

→ list_databases()

返回示例：

{
  "success": true,
  "data": [
    { "type": "mysql", "configured": true, "sources": ["primary", "replica", "analytics"] },
    { "type": "postgres", "configured": true, "sources": ["main", "archive"] },
    { "type": "mongodb", "configured": false, "sources": [] }
  ]
}

查询指定数据源

"查询主库中 users 表的数据"
→ query_database(db_type="mysql", connection_name="primary", query="SELECT * FROM users LIMIT 10")

"从报表库查询销售数据"
→ query_database(db_type="mysql", connection_name="analytics", query="SELECT * FROM sales_report WHERE date > '2024-01-01'")

MongoDB 查询

"查询主 MongoDB 中状态为 pending 的订单"
→ query_database(db_type="mongodb", connection_name="main", query='{"collection":"orders","filter":{"status":"pending"}}')

Redis 查询

"从缓存 Redis 获取用户会话"
→ query_database(db_type="redis", connection_name="cache", query="GET session:user:123")

不指定 connection_name（使用 default）

"查询默认数据源的表列表"
→ list_tables(db_type="mysql")

🔒 安全特性

  • ✅ 默认只读模式，禁止写操作 INSERT/UPDATE/DELETE
  • ✅ 自动添加 LIMIT 防止返回过多数据
  • ✅ 查询超时保护
  • ✅ SQL 注入防护
  • ✅ 敏感信息脱敏
  • ✅ 标识符验证（防止非法表名/schema名）

🛠 本地开发

git clone https://github.com/yourusername/polyquery-mcp.git
cd polyquery-mcp
npm install
npm run build

📚 配置场景示例

场景 1：读写分离

{
  "env": {
    "MYSQL_primary": "mysql://write_user:pass@master:3306/app",
    "MYSQL_replica": "mysql://read_user:pass@slave:3306/app"
  }
}

场景 2：多业务库

{
  "env": {
    "POSTGRES_orders": "postgresql://user:pass@host:5432/orders",
    "POSTGRES_users": "postgresql://user:pass@host:5432/users",
    "POSTGRES_inventory": "postgresql://user:pass@host:5432/inventory"
  }
}

场景 3：多环境管理

{
  "env": {
    "MYSQL_dev": "mysql://user:pass@dev-host:3306/app",
    "MYSQL_test": "mysql://user:pass@test-host:3306/app",
    "MYSQL_prod": "mysql://user:pass@prod-host:3306/app"
  }
}

场景 4：Redis 多用途

{
  "env": {
    "REDIS_cache": "redis://:pass@host:6379/0",
    "REDIS_session": "redis://:pass@host:6379/1",
    "REDIS_queue": "redis://:pass@host:6379/2"
  }
}

场景 5：密码含特殊字符

密码中的特殊字符需 URL 编码：$ → %24，# → %23，! → %21，^ → %5E

{
  "env": {
    "ORACLE_prod": "oracle://scott:P%40ss%24w0rd%21@host:1521/pdb1"
  }
}

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

相关 MCP