Provides tools for managing MySQL databases, including listing tables, getting schemas, and executing SQL queries.
Provides tools for managing PostgreSQL databases, including listing tables, getting schemas, and executing SQL queries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SQL MCP Server list tables in prod-mysql"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
动态 SQL MCP 服务，支持 MySQL 与 PostgreSQL。所有数据库连接在运行时通过 MCP tool 参数传入，无需配置文件；同时支持 stdio（适合 Claude Desktop 等本地客户端）和 sse（适合 Docker 远程部署）两种 transport。
支持 MySQL 8 与 PostgreSQL 16
支持 stdio / sse 双 transport
运行时动态传入数据库连接（connection 对象）
可选的 alias 注册/释放机制，便于复用连接
默认只读执行；通过 allow_write: true 显式开启写入
连接池自动缓存与回收
提供 5 个 MCP tools：
register_database
unregister_database
list_db_servers
list_database_tables
get_table_schema
query_database
Related MCP server: mcp-database
pip install -r requirements.txt
python -m src.server --transport sse --host 127.0.0.1 --port 3000docker build -t sql-mcp .
docker run -p 3000:3000 -e SQL_MCP_HOST=0.0.0.0 -e LOG_LEVEL=INFO sql-mcpdocker compose up -d服务默认监听 http://0.0.0.0:3000，SSE endpoint 为 http://localhost:3000/sse。
# 使用 requirements.txt
pip install -r requirements.txt
# 或作为可编辑包安装
pip install -e .需要 Python >= 3.11。
python -m src.server --transport stdiopython -m src.server --transport sse --host 0.0.0.0 --port 3000命令行参数也可通过环境变量设置：
参数 | 环境变量 | 默认值 | 说明 |
|
|
| SSE 监听地址 |
|
|
| SSE 监听端口 |
- |
|
| 日志级别（DEBUG/INFO/WARNING/ERROR） |
注册一个数据库连接别名，后续可通过 alias 复用该连接。注册同名别名会覆盖旧连接，并自动释放旧连接池。
参数
参数 | 类型 | 必填 | 说明 |
|
| 是 | 别名 |
|
| 是 | 数据库连接对象 |
示例
{
"alias": "prod-mysql",
"connection": {
"type": "mysql",
"host": "localhost",
"port": 3306,
"user": "root",
"password": "secret",
"database": "mydb"
}
}返回
{ "status": "ok", "alias": "prod-mysql", "type": "mysql" }释放一个已注册的别名，并关闭对应的连接池。
参数
参数 | 类型 | 必填 | 说明 |
|
| 是 | 要释放的别名 |
示例
{ "alias": "prod-mysql" }返回
{ "status": "ok", "alias": "prod-mysql" }若别名不存在：
{ "status": "not_found", "alias": "prod-mysql" }列出所有已注册的连接元信息（不含密码）。
返回
[
{
"alias": "prod-mysql",
"type": "mysql",
"host": "localhost",
"port": 3306,
"database": "mydb",
"ssl": false
}
]列出数据库中的所有表。支持通过 alias 或完整 connection 对象定位数据库，二者只能选其一。
参数
参数 | 类型 | 必填 | 说明 |
|
| 二选一 | 已注册的别名 |
|
| 二选一 | 完整连接对象 |
示例
{ "alias": "prod-mysql" }返回
{ "tables": ["users", "orders"] }获取指定表的结构信息，包括列、主键约束、索引。
参数
参数 | 类型 | 必填 | 说明 |
|
| 是 | 表名 |
|
| 二选一 | 已注册的别名 |
|
| 二选一 | 完整连接对象 |
示例
{
"alias": "prod-mysql",
"table_name": "users"
}返回
{
"columns": [
{ "name": "id", "type": "INTEGER", "nullable": false, "default": null },
{ "name": "name", "type": "VARCHAR", "nullable": true, "default": null }
],
"primary_key": { "name": "pk_users", "constrained_columns": ["id"] },
"indexes": [...]
}执行 SQL 查询。默认处于只读模式，禁止 INSERT/UPDATE/DELETE/DROP 等写入操作；传入 allow_write: true 可显式开启写入。
参数
参数 | 类型 | 必填 | 说明 |
|
| 是 | SQL 语句 |
|
| 二选一 | 已注册的别名 |
|
| 二选一 | 完整连接对象 |
|
| 否 | SQL 参数（命名参数） |
|
| 否 | 只读查询默认最大返回行数，默认 |
|
| 否 | 是否允许写入，默认 |
只读查询示例
{
"alias": "prod-mysql",
"sql": "SELECT * FROM users WHERE name = :name",
"params": { "name": "Alice" },
"limit": 100
}写入示例
{
"alias": "prod-mysql",
"sql": "INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com')",
"allow_write": true
}返回
查询语句：结果数组
写入语句：{ "rows_affected": 1 }
字段 | 类型 | 必填 | 说明 |
|
| 是 | 数据库类型： |
|
| 是 | 数据库主机 |
|
| 否 | 端口；MySQL 默认 |
|
| 是 | 用户名 |
|
| 是 | 密码 |
|
| 是 | 数据库名 |
|
| 否 | 是否启用 SSL，默认 |
变量 | 默认值 | 说明 |
|
| SSE 监听地址 |
|
| SSE 监听端口 |
|
| 日志级别 |
| - | 建议设为 |
项目使用 pytest 做单元测试，使用 scripts/agents/ 下的 Agent 脚本做集成测试。
bash scripts/start-test-infra.sh该脚本会启动 PostgreSQL、MySQL 两个 Docker 容器，并在 localhost:3000 启动 SSE 模式的 MCP 服务。
python -m pytest tests/test_basic.py -vpython -m pytest tests/integration/test_mcp_server.py -vpython scripts/agents/agent_postgres.py
python scripts/agents/agent_mysql.py
python scripts/agents/agent_security.py
python scripts/agents/agent_direct_connection.py
python scripts/agents/agent_extensibility.pybash scripts/stop-test-infra.sh当前版本通过 MCP tool 参数明文传入数据库凭据，请求会经过 MCP 客户端、网络传输（SSE）以及服务端日志。该方案适用于：
受控内网环境
本地开发/测试
快速原型验证
生产环境建议：
启用 SSE TLS（如通过反向代理提供 HTTPS）
限制可访问的源 IP
由服务端通过环境变量/密钥管理系统加载凭据模板，客户端 tool 参数只传 alias
开启审计日志并避免在日志中记录 password 与原始 SQL 参数
只读守卫基于 SQL 前缀与关键字做最佳努力检测，不能替代数据库级权限控制。建议为 MCP 服务单独配置权限受限的数据库账号。
This server cannot be deployed
Read-only PostgreSQL, MySQL, SQL Server access via MCP — 24 dialect-aware hosted tools.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Draxlr's remote MCP server connects AI assistants to your SQL databases and dashboards. Explore schemas, run read-only queries, manage saved queries and dashboards, and export results, all with row-level security so each user sees only their own data.
