PostgreSQL MCP 服务器

一个通用的 PostgreSQL 模型上下文协议 (MCP) 服务器，允许 AI 智能体安全地检查和查询 PostgreSQL 数据库。

功能

• list_tables: 列出 public 架构中的所有表。

• get_schema: 获取特定表的架构（列、类型、可空性）。

• run_query: 运行只读 SQL 查询（仅允许 SELECT/WITH），最大限制为 100 行，以避免过大的响应。

Related MCP server: PostgreSQL MCP Server

先决条件

• Python 3.13+

• uv

• PostgreSQL 数据库

安装

如果您克隆了存储库，可以直接使用 uvx 或 uv run 运行此程序。

使用方法

此服务器需要设置 DATABASE_URL 环境变量。

连接字符串示例： postgres://user:password@localhost:5432/mydatabase

直接运行

DATABASE_URL="postgresql://postgres:poggerpogger@localhost:5432/boxboxWeb" uv run main.py

在 Claude Desktop / MCP 客户端中使用

将以下内容添加到您的 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "postgres": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/2025postgresqlmcp/main.py"
      ],
      "env": {
        "DATABASE_URL": "postgres://user:password@localhost:5432/mydatabase"
      }
    }
  }
}