Simple Postgres MCP

PostgreSQL MCP服务器

一种模型上下文协议（MCP）服务器，提供与PostgreSQL数据库交互的工具。

工具

• read_query -执行SELECT查询以从数据库中读取数据
• list_tables -获取数据库中所有表的列表
• describe_table -查看特定表的架构信息

安装

1.创建并激活虚拟环境

cd 

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2.安装包装

pip install -e .

用法

服务器支持两种传输模式：

• 标准 （默认）-标准输入/输出，用于直接MCP客户端集成
• 超文本传输协议 -具有流式传输的HTTP，适用于独立服务器模式

命令行

postgres-mcp --host  --port 
 --database  --user  --password 
 [--transport stdio|http]

论据：

示例（stdio模式）：

postgres-mcp --host localhost --port 5432 --database mydb --user admin --password secret

示例（HTTP模式）：

postgres-mcp --host localhost --database mydb --user admin --password secret --transport http --http-port 8080

作为Python模块

python -m postgres_mcp --host localhost --database mydb --user admin --password secret

使用run.sh（用于具有IAM身份验证的AWS RDS）

这 run.sh 该脚本处理AWS RDS IAM身份验证和SSL配置：

./run.sh

此脚本：

• 为RDS设置SSL证书
• 通过以下方式生成临时IAM身份验证令牌 aws-vault
• 在上以HTTP模式启动MCP服务器 http://127.0.0.1:8080/mcp
• 在运行脚本之前，您需要为凭据和RDS连接详细信息配置环境变量。

MCP客户端配置

HTTP模式（建议用于AWS RDS/复杂环境）

1. 在具有正确环境的终端中启动服务器：

   ./run.sh

1. 配置您的MCP客户端：

对于直接支持HTTP的客户端（例如Cursor）：

   {
     "mcpServers": {
       "postgres": {
         "type": "streamable-http",
         "url": "http://127.0.0.1:8080/mcp"
       }
     }
   }

对于只支持stdio的客户端（例如Claude Code）：

使用stdio到HTTP代理：

   {
     "mcpServers": {
       "postgres": {
         "command": "
/.venv/bin/postgres-mcp-proxy",
         "args": ["--server-url", "http://127.0.0.1:8080/mcp"]
       }
     }
   }

标准模式（用于简单设置）

直接执行

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "postgres": {
      "command": "
/.venv/bin/postgres-mcp",
      "args": [
        "--host", "localhost",
        "--port", "5432",
        "--database", "mydb",
        "--user", "admin",
        "--password", "secret"
      ]
    }
  }
}

克劳德代码：

{
  "mcpServers": {
    "postgres": {
      "command": "
/.venv/bin/postgres-mcp",
      "args": [
        "--host", "localhost",
        "--port", "5432",
        "--database", "mydb",
        "--user", "admin",
        "--password", "secret"
      ]
    }
  }
}

发展

在开发模式下安装

pip install -e .

项目结构

db-mcp/
├── pyproject.toml
├── README.md
├── run.sh                   # AWS RDS launcher script
└── src/
    └── postgres_mcp/
        ├── __init__.py
        ├── __main__.py      # CLI entry point
        ├── database.py      # Connection pool management
        ├── server.py        # MCP server implementation
        └── proxy.py         # Stdio-to-HTTP proxy for Claude Code