mcp-server-postgres

mcp-server-postgres

适用于 PostgreSQL 数据库的 Model Context Protocol 服务。此服务可让大模型检查数据库架构并执行只读查询。

功能

• 对 PostgreSQL 数据库进行只读访问
• 检查架构
• 在 READ ONLY 事务中安全执行查询
• 支持 Docker
• 提供 NPM 软件包

安装

使用 Docker

# Build the Docker image
make docker

# Run with Docker
docker run -i --rm mcp/postgres postgresql://host:port/dbname

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 PostgreSQL Database Server：

npx -y @smithery/cli install @yuru-sha/mcp-server-postgres --client claude

使用方法

配合 Claude Desktop 使用

将以下配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/postgres",
        "postgresql://host:port/dbname"
      ]
    }
  }
}

注意：在 macOS 上使用 Docker 时，如果 PostgreSQL 服务运行在主机网络上，请使用 host.docker.internal。

连接 URL 格式

postgresql://[user][:password]@host[:port]/database

将 /database 替换为你的数据库名称。

开发

# Initial setup
make setup

# Build the project
make build

# Format code
make format

# Run linter
make lint

许可证

此项目基于 MIT License 发布。

安全性

此服务强制执行只读访问，以保护你的数据库。所有查询均在 READ ONLY 事务中执行。

为增强安全性，我们建议创建只读用户。

贡献

欢迎贡献！请随时提交 Pull Request。