一个提供同时访问多个数据库工具的 MCP（模型上下文协议）服务器。该服务器在 Docker 中运行，并支持并行查询不同类型的多个数据库。此服务器的灵感来源于数据库对比或支持迁移的需求。
多种数据库类型：支持 PostgreSQL、MySQL/MariaDB、SQL Server 和 SQLite
多数据库支持：同时连接并查询多个数据库（甚至是不同类型的数据库）
并行查询：一次性在多个数据库上执行相同的查询
架构探索：列出数据库、架构、表，并描述表结构
容器化：在 Docker 容器中运行，便于部署
连接池：为所有数据库类型提供高效的连接管理
灵活配置：按类型组织数据库
Related MCP server: Universal SQL MCP Server
list_databases - 列出所有已配置的数据库连接
query_database - 在特定数据库上执行 SQL 查询
list_tables - 列出数据库架构中的所有表
describe_table - 获取表的详细架构信息
list_schemas - 列出数据库中的所有架构
query_multiple_databases - 同时在多个数据库上执行相同的查询
复制示例配置文件并使用您的数据库凭据进行编辑：
cp databases.json.example databases.json使用您的数据库连接详细信息编辑 databases.json。在根级别按类型组织数据库：
{
"postgresql": {
"postgres_db": {
"host": "localhost",
"port": 5432,
"user": "postgres",
"password": "your_password",
"database": "database1"
},
"another_postgres": {
"host": "remote.example.com",
"port": 5432,
"user": "admin",
"password": "secret",
"database": "production"
}
},
"mysql": {
"mysql_db": {
"host": "localhost",
"port": 3306,
"user": "root",
"password": "your_password",
"database": "mydatabase"
}
},
"sqlserver": {
"sqlserver_db": {
"host": "localhost",
"port": 1433,
"user": "sa",
"password": "your_password",
"database": "MyDatabase"
}
},
"sqlite": {
"sqlite_db": {
"database": "/path/to/database.db"
}
},
"clickhouse": {
"clickhouse_db": {
"host": "localhost",
"port": 8123,
"user": "default",
"password": "",
"database": "default"
}
}
}PostgreSQL ("postgresql", "postgres", 或 "pg")
MySQL/MariaDB ("mysql" 或 "mariadb")
SQL Server ("sqlserver", "mssql", 或 "sql server")
SQLite ("sqlite" 或 "sqlite3")
ClickHouse ("clickhouse" 或 "ch")
docker-compose up --build# Build the image
docker build -t multidb-mcp-server .
# Run the container
docker run -it \
-v $(pwd)/databases.json:/app/databases.json:ro \
multidb-mcp-server在 Docker 内部配置数据库连接时，请记住以下提示：
访问宿主机数据库：使用 host.docker.internal 作为主机名（Windows/Mac）或 172.17.0.1（Linux）
访问其他容器：使用 docker-compose.yml 中的容器名称或服务名称
访问远程数据库：使用实际的主机名或 IP 地址
访问宿主机 PostgreSQL 的示例：
{
"postgresql": {
"local_db": {
"host": "host.docker.internal",
"port": 5432,
"user": "postgres",
"password": "password",
"database": "mydb"
}
}
}访问另一个 Docker 容器中数据库的示例：
{
"postgresql": {
"container_db": {
"host": "postgres-container",
"port": 5432,
"user": "postgres",
"password": "password",
"database": "mydb"
}
}
}访问宿主机 SQL Server 的示例：
{
"sqlserver": {
"sqlserver_db": {
"host": "host.docker.internal",
"port": 1433,
"user": "sa",
"password": "password",
"database": "MyDatabase"
}
}
}关于 SQL Server 的说明：确保 SQL Server 配置为接受 TCP/IP 连接，并且如果使用命名实例，则 SQL Server Browser 服务正在运行。默认端口为 1433。
宿主机上的 SQLite 数据库：将包含数据库文件的目录挂载为卷，并使用容器路径
容器内的 SQLite 数据库：使用容器内的绝对路径
带有 SQLite 卷的 Docker 运行命令示例：
docker run -it \
-v $(pwd)/databases.json:/app/databases.json:ro \
-v $(pwd)/data:/app/data:ro \
multidb-mcp-serverSQLite 配置示例：
{
"sqlite": {
"local_db": {
"database": "/app/data/mydatabase.db"
}
}
}注意：路径 /app/data/mydatabase.db 是容器内的路径，它通过卷挂载映射到宿主机上的 ./data/mydatabase.db。
服务器通过 stdio 使用 MCP 协议进行通信。将您的 MCP 客户端连接到 Docker 容器的 stdio 流。
如果与 MCP 客户端一起使用，请将其配置为连接到 Docker 容器：
{
"mcpServers": {
"multidb": {
"command": "docker",
"args": [
"run",
"-i",
"-v",
"[YOUR/PATH]/databases.json:/app/databases.json:ro",
"multidb-mcp-server"
]
}
}
}{
"tool": "list_databases",
"arguments": {}
}{
"tool": "query_database",
"arguments": {
"database_name": "db1",
"query": "SELECT * FROM users LIMIT 10"
}
}{
"tool": "list_tables",
"arguments": {
"database_name": "db1",
"schema": "public"
}
}{
"tool": "describe_table",
"arguments": {
"database_name": "db1",
"table_name": "users",
"schema": "public"
}
}您可以同时查询不同类型的多个数据库：
{
"tool": "query_multiple_databases",
"arguments": {
"database_names": ["db1", "db2", "sqlserver_db"],
"query": "SELECT COUNT(*) as total FROM users"
}
}注意：在查询不同类型的多个数据库时，请确保 SQL 语法在所有数据库类型中兼容，或者为每个数据库分别使用特定于数据库的查询。
安装依赖项：
pip install -r requirements.txt设置环境变量：
export DB_CONFIG_PATH=./databases.json运行服务器：
python server.py默认端口：5432
默认架构：public
使用 asyncpg 进行异步操作
默认端口：3306
架构参数是可选的（使用当前数据库）
使用 aiomysql 进行异步操作
默认端口：1433
默认架构：dbo
需要 Microsoft ODBC Driver for SQL Server（首选 v18，也支持 v17；已安装在 Docker 镜像中）
使用带有 asyncio 包装器的 pyodbc
重要：SQL Server 必须配置为接受 TCP/IP 连接
对于命名实例，确保 SQL Server Browser 服务正在运行
使用 host.docker.internal 从 Docker 连接到宿主机上的 SQL Server
无需网络连接
使用 database 字段指定文件路径（或使用 :memory: 进行内存中操作）
默认架构：main
使用 aiosqlite 进行异步操作
切勿提交 databases.json - 它包含敏感凭据
在生产环境中使用环境变量或密钥管理
考虑对远程数据库使用 SSL/TLS 连接
限制对 Docker 容器的网络访问
对于 SQLite，确保文件路径安全且可访问
验证 databases.json 中的数据库凭据
确保从 Docker 容器可以访问数据库
检查网络连通性（使用 docker network 进行容器间通信）
确保 databases.json 文件具有正确的读取权限
检查 Docker 卷挂载是否正确
MIT
This server cannot be deployed
PostgreSQL, MySQL, and SQL Server in one session. 26 read-only MCP tools for AI agents.
Query Postgres, MySQL, SQL Server, Oracle, BigQuery, ClickHouse and Redshift from your AI client.
Explore, query, and inspect SQLite databases with ease. List tables, preview results, and view det…
PostgreSQL, MySQL, OpenAPI/Swagger, and shared Agent Memory with scoped access.
