Enhanced PostgreSQL MCP server with read and write capabilities. Based on @modelcontextprotocol/server-postgres by Anthropic.
sql（字符串）：要执行的SQL查询
sql（字符串）：要执行的SQL语句
table（字符串）：表名
data（对象）：键值对，其中键是列名，值是要插入的数据
table（字符串）：表名
data（对象）：要更新字段的键值对
where（字符串）：用于标识要更新记录的WHERE条件
table（字符串）：表名
where（字符串）：用于标识要删除记录的WHERE条件
tableName（字符串）：表名
columns（数组）：列定义数组，包含名称、类型和可选约束
constraints（数组）：可选的表级约束数组
name（字符串）：函数名
parameters（字符串）：函数参数
returnType（字符串）：返回类型
language（字符串）：语言（plpgsql、sql等）
body（字符串）：函数体
options（字符串）：可选的附加函数选项
name（字符串）：触发器名称
tableName（字符串）：应用触发器的表
functionName（字符串）：要调用的函数
when（字符串）：BEFORE、AFTER或INSTEAD OF
events（数组）：事件数组（INSERT、UPDATE、DELETE）
forEach（字符串）：ROW或STATEMENT
condition（字符串）：可选的WHEN条件
tableName（字符串）：表名
indexName（字符串）：索引名
columns（数组）：要索引的列
unique（布尔值）：索引是否唯一
type（字符串）：可选的索引类型（BTREE、HASH、GIN、GIST等）
where（字符串）：可选条件
tableName（字符串）：表名
operation（字符串）：操作（ADD COLUMN、DROP COLUMN等）
details（字符串）：操作详情
postgres:////schema）
- 每个表的JSON模式信息
- 包括列名和数据类型
- 从数据库元数据自动发现
在Claude Desktop中使用
要在Claude Desktop应用程序中使用此服务器，请将以下配置添加到claude_desktop_config.json的"mcpServers"部分：
$3
* docker镜像需要自己编译
* 在macOS上运行docker时，如果服务器在主机网络上运行（例如localhost），请使用host.docker.internal
* 用户名/密码可以通过postgresql://user:password@host:port/db-name添加到postgresql url中
* 如果需要绕过SSL证书验证，请添加?sslmode=no-verify
$3
``json
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": [
"-y",
"enhanced-postgres-mcp-server",
"postgresql://username:password@localhost:5432/mydb"
]
}
}
}
`
连接字符串格式说明：
- postgresql://username:password@localhost:5432/mydb - 包含用户名和密码的完整格式
- postgresql://localhost/mydb - 使用默认用户的简化格式
- postgresql://postgres:mypassword@localhost:5432/mydatabase - 示例：用户名postgres，密码mypassword，数据库mydatabase
SSL连接支持：
服务器支持多种SSL配置方式，可以根据您的数据库环境选择合适的方法：
1. URL参数方式（推荐）：
- postgresql://username:password@host:5432/db?ssl=true - 启用SSL连接
- postgresql://username:password@host:5432/db?sslmode=require - 要求SSL连接
- postgresql://username:password@host:5432/db?sslmode=no-verify - SSL连接但跳过证书验证
2. 环境变量方式：
- 设置 POSTGRES_SSL=true 环境变量来启用SSL
- 设置 POSTGRES_SSL_FORCE=true 强制启用SSL（覆盖URL设置）
- 设置 POSTGRES_SSL_REJECT_UNAUTHORIZED=true 启用严格的证书验证（默认为false）
3. 自动SSL检测：
- 远程连接（非localhost/127.0.0.1）会自动启用SSL
- 本地连接默认不使用SSL，除非明确指定
SSL配置示例：
`json
{
"mcpServers": {
"postgres-ssl": {
"command": "npx",
"args": [
"-y",
"enhanced-postgres-mcp-server",
"postgresql://username:password@remote-db.example.com:5432/mydb?ssl=true"
]
}
}
}
`
注意事项：
- 对于自签名证书或开发环境，建议使用 ?sslmode=no-verify 或设置 POSTGRES_SSL_REJECT_UNAUTHORIZED=false
- 生产环境建议使用有效的SSL证书并启用证书验证
- 如果数据库要求SSL连接，请确保在连接字符串中包含相应的SSL参数
将连接字符串中的参数替换为您的实际数据库配置。
使用示例
$3
`
/query SELECT * FROM postgres_log LIMIT 5
`
$3
`
/insert table="users", data={"name": "张三", "email": "zhangsan@example.com"}
`
$3
`
/update table="users", data={"status": "inactive"}, where="id='123'"
`
$3
`
/createTable tableName="tasks", columns=[
{"name": "id", "type": "SERIAL", "constraints": "PRIMARY KEY"},
{"name": "title", "type": "VARCHAR(100)", "constraints": "NOT NULL"},
{"name": "created_at", "type": "TIMESTAMP", "constraints": "DEFAULT CURRENT_TIMESTAMP"}
]
`
$3
`
/createFunction name="update_timestamp", parameters="", returnType="TRIGGER", language="plpgsql", body="BEGIN NEW.updated_at = NOW(); RETURN NEW; END;"
/createTrigger name="set_timestamp", tableName="tasks", functionName="update_timestamp", when="BEFORE", events=["UPDATE"], forEach="ROW"
`
构建
Docker：
`sh
docker build -t mcp/postgres -f Dockerfile .
``
安全考虑
1. 所有数据修改操作都使用具有适当COMMIT/ROLLBACK处理的事务
2. 每个操作都返回执行的SQL以确保透明度
3. 服务器对插入/更新操作使用参数化查询以防止SQL注入
许可证
此MCP服务器根据MIT许可证授权。这意味着您可以自由使用、修改和分发软件，但需遵守MIT许可证的条款和条件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。