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文件。