SQL MCP

一个支持 MySQL 和 PostgreSQL 的动态 SQL MCP 服务。所有数据库连接在运行时通过 tool 参数传入，无需配置文件。

特性

• 支持 MySQL 和 PostgreSQL

• SSE/HTTP transport，适合 Docker 远程部署

• 运行时动态传入数据库连接

• 可选 alias 注册机制，便于复用连接

• 提供 list_db_servers、list_database_tables、get_table_schema、query_database 工具

Related MCP server: MCP Universal DB Client

快速开始

本地运行

pip install -r requirements.txt
python -m src.server --transport sse --port 3000

Docker 运行

docker build -t sql-mcp .
docker run -p 3000:3000 sql-mcp

MCP Tools

register_database

注册一个数据库连接别名。

{
  "alias": "prod-mysql",
  "connection": {
    "type": "mysql",
    "host": "localhost",
    "port": 3306,
    "user": "root",
    "password": "secret",
    "database": "mydb"
  }
}

list_db_servers

列出已注册的数据库连接（不返回密码）。

list_database_tables

列出数据库表。支持 alias 或完整 connection 对象。

{
  "alias": "prod-mysql"
}

get_table_schema

获取表结构。

{
  "alias": "prod-mysql",
  "table_name": "users"
}

query_database

执行 SQL 查询。默认只读，可通过 allow_write: true 允许写入操作。

{
  "alias": "prod-mysql",
  "sql": "SELECT * FROM users LIMIT 10"
}

安全提示

当前版本通过 tool 参数明文传入数据库凭据，适用于受控内网或开发环境。生产环境建议：

• 启用 SSE TLS

• 服务端通过环境变量加载凭据模板，tool 参数只传 alias

• 限制可访问的源 IP