🚀 PostgreSQL 全访问 MCP 服务器

PostgreSQL 全访问 MCP（机器学习平台）服务器是一款强大的工具，它能让你对 PostgreSQL 数据库进行全面的读写操作。同时，它还具备诸多高级功能，如提供详细的 schema 信息、支持事务处理、展示索引与外键详情等，为数据库管理带来极大便利。

✨ 主要特性

概述

PostgreSQL 全访问 MCP 服务器可对 PostgreSQL 数据库进行完全访问，涵盖读取和写入操作，还提供增强的 schema 细节、事务支持、索引信息、外键细节、行估计数、表描述等高级功能。

核心特性

• 读写访问：支持 SELECT、INSERT、UPDATE、DELETE 等各类数据库操作。
• 增强型 Schema 详情：提供详尽的表结构信息，包含索引和外键关系。
• 事务支持：可显式控制事务，具备超时机制保障数据一致性。
• 索引与外键信息：展示表的索引和外键细节。
• 行数量估计：对表中记录数进行估算。
• 表描述：包含每个表的详细描述信息。

优势

相较于官方 PostgreSQL MCP 服务器，本服务器功能更全面，支持更多高级操作，且提供更详细的数据库元数据。

📦 安装指南

使用 Docker 运行

# 构建 Docker 镜像
docker build -t mcp-postgres-full-access .

# 启动容器
docker run -i --rm mcp-postgres-full-access "postgresql://username:password@host:5432/database"

⚠️ 重要提示

在 macOS 系统上，使用 host.docker.internal 代替主机名以连接到 Docker 容器的网络。

💻 使用示例

基础用法

创建新表并添加数据

用户: "我需要创建一个包含 id、名称、价格和库存的新产品表"

Claude: 分析数据库并生成查询

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price DECIMAL(10,2) NOT NULL,
    inventory INTEGER DEFAULT 0
);

用户: 审核后点击“允许一次”

Claude: "我已经创建了产品表。是否需要添加一些示例数据？"

用户: "是的，请添加5条示例产品数据"

Claude: 生成插入语句并请求批准 用户审核后点击“允许一次”

数据分析（只读操作）

用户: "请告诉我价格最高的3款产品是什么？"

Claude: 执行只读查询并显示结果

🔒 安全注意事项

数据库用户权限

⚠️ 重要提示

使用一个受限的数据库用户，并授予其必要的最小权限。

-- 示例：创建受限用户（根据需要进行调整）
CREATE USER claude_user WITH PASSWORD 'secure_password';
GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;
GRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;
-- 根据需求授予特定权限

使用最佳实践

💡 使用建议

1. 始终使用“允许一次”：在执行写入操作前，仔细审核每条指令。永远不要选择“总是允许”，除非你已充分验证过代码。
2. 连接到测试数据库：初次使用时，请链接到一个测试或备份数据库。
3. 谨慎处理敏感数据：确保数据库中的敏感信息得到妥善保护。

📚 详细文档

功能模块

1. PostgreSQL 全访问功能
   • 支持完整的 SQL 查询，包括 DDL 和 DML 操作。
   • 提供详细的查询结果和执行计划。
2. 增强型 Schema 信息
   • 显示表结构、索引、外键等详细信息。
   • 支持自动生成数据库文档。
3. 事务控制
   • 允许显式开始和提交事务。
   • 设置超时机制以防止死锁和其他并发问题。
4. 性能优化工具
   • 提供查询执行计划分析。
   • 显示表空间使用情况和索引统计信息。

安装与配置

快速安装

# 使用 Docker 启动 MCP 服务器
docker run -d --name mcp-server -p 5000:5000 mcr.microsoft.com/mssql-tools:latest

配置选项

• 端口映射：默认使用 5000 端口。
• 环境变量配置：

docker run -e PGPORT=5432 -e PGUSER=username -e PGPASSWORD=password ...

使用教程

创建新数据库

CREATE DATABASE my_database;
\c my_database;  -- 切换到新数据库

管理用户与权限

CREATE USER new_user WITH PASSWORD 'securepass';
GRANT ALL PRIVILEGES ON DATABASE my_database TO new_user;

示例查询

-- 查询所有产品及其价格
SELECT * FROM products ORDER BY price DESC;

-- 插入新记录
INSERT INTO products (name, price, inventory) VALUES ('New Product', 99.99, 10);

安全与合规

数据加密

• 传输中加密：确保所有数据库连接使用 SSL 加密。
• 数据-at-rest 加密：对存储的数据进行加密，防止物理盗窃。

审计日志

• 记录所有用户操作和查询历史。
• 配置审核策略以监控敏感操作。

符合法规

• 确保遵守 GDPR、HIPAA 等数据保护法规。
• 定期进行安全审计和漏洞扫描。

常见问题

为什么需要增强型 Schema 信息？

• 回答：增强型 Schema 信息有助于更好地理解数据库结构，优化查询性能，并生成文档。

如何处理大事务？

• 解答：建议将长事务分解为多个小事务，并定期提交以避免锁定问题。

总结

PostgreSQL 全访问 MCP 服务器功能全面，适用于需要完全控制和详细信息的数据库管理场景。通过 Docker 容器化部署，可轻松集成到现有环境中，同时保障安全性和性能优化。