PostgreSQL Products MCP Server

基本能力

产品定位

PostgreSQL Products MCP Server 是一个数据库交互服务，专门用于通过 MCP 协议与 PostgreSQL 数据库进行通信，主要针对产品信息查询场景。

核心功能

1. 提供 run_sql_query 工具，允许执行只读 SQL 查询（SELECT 语句）。
2. 支持通过环境变量配置 PostgreSQL 数据库连接参数。
3. 与 MCP 客户端无缝集成，便于 AI 助手等工具访问数据库。

适用场景

1. 产品库存查询
2. 产品分类检索
3. 电子商务系统中的产品信息展示
4. 数据分析报表生成

工具列表

1. run_sql_query：执行只读 SQL 查询（SELECT 语句）的工具。
2. 能力：接收 SQL SELECT 查询字符串，执行查询并返回结果。
3. 输入要求：必须包含有效的 SQL SELECT 语句。

常见问题解答

1. 如何配置数据库连接？
2. 通过设置环境变量 PGHOST、PGPORT、PGUSER、PGPASSWORD 和 PGDATABASE 来配置。
3. 支持哪些类型的 SQL 语句？
4. 目前仅支持 SELECT 查询语句。
5. 如何确保查询安全？
6. 该工具仅执行只读查询，不会修改数据库内容。

使用教程

使用依赖

1. Node.js (v18 或更高版本)
2. npm 或 yarn
3. 访问具有产品架构的 PostgreSQL 数据库

安装教程

1. 克隆仓库： bash git clone https://github.com/michael7736/postgres-mcp-server.git cd postgres-mcp-server
2. 安装依赖： bash npm install # 或 yarn install
3. 构建项目： bash npm run build # 或 yarn build

调试方式

1. 确保环境变量已正确设置
2. 检查 MCP 客户端配置是否正确
3. 测试简单查询： xml <use_mcp_tool> <server_name>postgres-products</server_name> <tool_name>run_sql_query</tool_name> <arguments> { "query": "SELECT product_name FROM products LIMIT 1;" } </arguments> </use_mcp_tool>

许可证

None