PostgreSQL Products MCP Server

PostgreSQL Products MCP 服务

这是一个模型上下文协议（MCP）服务，旨在与包含产品信息的 PostgreSQL 数据库交互。它允许客户端（例如 AI 助手）使用 SQL 查询数据库。

前提条件

• Node.js（建议使用 v18 或更高版本）
• npm 或 yarn
• 可访问包含 products 架构的 PostgreSQL 数据库。

安装

1. 克隆此仓库（或下载源代码）：

   git clone https://github.com/michael7736/postgres-mcp-server.git
   cd postgres-mcp-server
   

2. 安装依赖：

   npm install
   # or
   yarn install
   

构建

将 TypeScript 代码编译为 JavaScript：

npm run build
# or
yarn build

这将在 build/ 目录中创建可执行文件（build/index.js）。

配置

在 MCP 客户端设置中配置此服务时（例如，cline_mcp_settings.json 或 claude_desktop_config.json），需要通过环境变量提供 PostgreSQL 连接详情。

所需的环境变量如下：

• PGHOST：PostgreSQL 服务的主机名。
• PGPORT：PostgreSQL 服务的端口号（默认值：5432）。
• PGUSER：数据库连接的用户名。
• PGPASSWORD：数据库连接的密码。
• PGDATABASE：要连接的数据库名称。

MCP 设置配置示例：

{
  "mcpServers": {
    "postgres-products": {
      "command": "node",
      "args": ["/path/to/your/postgres-mcp-server/build/index.js"],
      "env": {
        "PGHOST": "your_db_host",
        "PGPORT": "5432",
        "PGUSER": "your_db_user",
        "PGPASSWORD": "your_db_password",
        "PGDATABASE": "your_db_name"
      },
      "disabled": false, // Ensure it's enabled
      "autoApprove": [] // Configure auto-approval if needed
    }
    // ... other servers
  }
}

将 /path/to/your/postgres-mcp-server/build/index.js 替换为系统上构建后的服务文件的实际路径，并在 env 部分填写你的具体数据库凭据。

使用方法

通过 MCP 客户端完成配置并运行后，此服务将提供以下工具：

run_sql_query

针对已配置的产品数据库执行只读 SQL 查询（仅限 SELECT 语句）。

输入架构：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The SQL SELECT query to execute."
    }
  },
  "required": ["query"]
}

工具调用示例：

<use_mcp_tool>
  <server_name>postgres-products</server_name>
  <tool_name>run_sql_query</tool_name>
  <arguments>
  {
    "query": "SELECT product_name, stock_quantity FROM products WHERE category = 'Electronics';"
  }
  </arguments>
</use_mcp_tool>