Mav Postgresql MCP Server

PostgreSQL MCP服务器

用于PostgreSQL数据库访问的综合模型上下文协议（MCP）服务器。提供36个工具，用于通过MCP接口查询、管理和与PostgreSQL数据库交互。

特性

• 36数据库工具：完整的只读和写入操作集
• PostgreSQL特定功能：模式支持、JSONB操作、扩展、函数、触发器、视图、序列
• 完全支持SSL/TLS：CA证书、客户端证书、可配置的TLS版本
• 安全第一：查询验证、速率限制、阻止危险操作
• 连接池：具有可配置限制的高效连接管理
• 审计日志：跟踪所有数据库操作

安装

# Clone or copy to your tools directory
cd /path/to/tools/mav-postgresql-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

配置

复制 .env.example 到 .env 并配置您的PostgreSQL连接：

cp .env.example .env

必要设置

SSL配置

安全设置

速率限制

用法

使用克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "postgresql": {
      "command": "node",
      "args": ["/path/to/mav-postgresql-mcp-server/build/index.js"],
      "env": {
        "PG_HOST": "localhost",
        "PG_PORT": "5432",
        "PG_USER": "your_user",
        "PG_PASSWORD": "your_password",
        "PG_DATABASE": "your_database",
        "PG_SCHEMA": "public",
        "ALLOW_WRITE_OPERATIONS": "false"
      }
    }
  }
}

与MCP检查员一起

npx @anthropic/mcp-inspector node build/index.js

可用工具

核心只读工具（7）

PostgreSQL专用只读工具（14）

写入操作工具（15）

*需要 ALLOW_WRITE_OPERATIONS=true*

MCP资源

服务器将数据库模式作为MCP资源公开：

• pg://database/schema -列出所有表和列
• pg://database/info -数据库信息
• pg://table/{schema}.{table} -单个表架构

安全功能

受阻操作

默认情况下，服务器会阻止危险操作：

• 文件系统操作(COPY FROM/TO, pg_read_file等等）
• 权限修改(GRANT, REVOKE, ALTER ROLE)
• 行政命令(CREATE ROLE, DROP DATABASE等等）
• 系统目录修改

受保护的表

对敏感系统表的访问被阻止：

• pg_catalog.pg_authid
• pg_catalog.pg_shadow
• pg_catalog.pg_auth_members

查询验证

• 所有标识符都经过验证（最多63个字符，仅限安全字符）
• 查询超时会阻止长时间运行的操作
• 限速防止滥用

设置只读用户

对于生产使用，创建一个专用的只读PostgreSQL用户：

# Run as PostgreSQL superuser
psql -U postgres -f setup-readonly-user.sql

或手动：

-- Create user
CREATE USER mcp_readonly WITH PASSWORD 'secure_password';

-- Grant connect
GRANT CONNECT ON DATABASE your_database TO mcp_readonly;

-- Grant schema usage
GRANT USAGE ON SCHEMA public TO mcp_readonly;

-- Grant read access to all tables
GRANT SELECT ON ALL TABLES IN SCHEMA public TO mcp_readonly;

-- Set default privileges for future tables
ALTER DEFAULT PRIVILEGES IN SCHEMA public
    GRANT SELECT ON TABLES TO mcp_readonly;

发展

# Run in development mode
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

故障排除

连接问题

1. 验证PostgreSQL是否正在运行： pg_isready -h localhost -p 5432
2. 检查凭据： psql -h localhost -U your_user -d your_database
3. 启用调试模式： MCP_DEBUG=true

SSL问题

1. 验证证书路径是否正确
2. 检查证书权限（运行服务器的用户可读）
3. 尝试 PG_SSL_MODE=require 首先，然后升级到 verify-ca 或 verify-full

速率限制

如果您达到了速率限制：

1. 增加 RATE_LIMIT_PER_MINUTE 和 RATE_LIMIT_PER_HOUR
2. 在可能的情况下进行批量操作
3. 使用更具体的查询来减少通话量

许可证

麻省理工学院