PostgreSQL MCP Server
2025.03.26
16
JavaScript数据库管理PostgreSQL 接口数据库
PostgreSQL MCP Server 是一个基于 Model Context Protocol 的服务，旨在为大型语言模型（LLMs）提供与 PostgreSQL 数据库交互的能力。该服务器允许 LLMs 检查数据库模式、执行查询以及对数据库条目执行 CRUD（创建、读取、更新、删除）操作。
View on GitHub
Overview
基本能力
产品定位
PostgreSQL MCP Server 是一个数据库交互工具，旨在通过 MCP 协议为大型语言模型提供与 PostgreSQL 数据库的直接交互能力。
核心功能
- 查询功能：执行只读 SQL 查询。
- 表操作：创建新表、删除现有表。
- 数据操作：插入、更新、删除表中的条目。
- 模式检查：自动发现并返回数据库表的 JSON 模式信息。
适用场景
- 自动化数据库管理任务
- 通过自然语言指令执行数据库操作
- 数据库模式的快速检查和验证
- 数据库内容的动态更新和管理
工具列表
- Docker：用于容器化部署 PostgreSQL 和 MCP 服务器。
- Claude Desktop：作为客户端与 MCP 服务器交互。
常见问题解答
- 连接问题：确保 Docker 容器正确运行，并且
claude_desktop_config.json中的配置正确。 - 权限问题：确保提供的 PostgreSQL 用户名和密码具有足够的权限。
使用教程
使用依赖
- 安装 Docker
- 安装 Claude Desktop
安装教程
- 克隆仓库：
git clone https://github.com/vignesh-codes/ai-agents-mcp-pg.git
- 运行 PostgreSQL 容器：
docker run --name postgres-container -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=admin_password -e POSTGRES_DB=mydatabase -p 5432:5432 -d postgres:latest
- 构建 MCP 服务器：
docker build -t mcp/postgres -f src/Dockerfile .
- 配置 Claude Desktop：更新
claude_desktop_config.json文件中的mcpServers部分。
调试方式
- 检查 Docker 容器状态：
docker ps
- 查看 PostgreSQL 日志：
docker logs postgres-container
- 测试数据库连接：
docker exec -it postgres-container psql -U admin -d mydatabase