MCP 服务器

PostgreSQL Products MCP Server

用于与 PostgreSQL 产品数据库交互的 MCP 服务器。

michael7736

开发者工具

访问服务器

README

PostgreSQL 产品 MCP 服务器

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

前提条件

Node.js (建议 v18 或更高版本)
npm 或 yarn
可以访问具有产品 schema 的 PostgreSQL 数据库。

安装

克隆此存储库（或下载源代码）：

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

安装依赖项：
```
npm install
# 或
yarn install
```

构建

将 TypeScript 代码编译为 JavaScript：

npm run build
# 或
yarn build

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

配置

此服务器需要通过环境变量提供 PostgreSQL 连接详细信息，以便在您的 MCP 客户端设置中进行配置（例如，cline_mcp_settings.json 或 claude_desktop_config.json）。

所需的环境变量包括：

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, // 确保已启用
      "autoApprove": [] // 如果需要，配置自动批准
    }
    // ... 其他服务器
  }
}

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

用法

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

`run_sql_query`

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

输入 Schema：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "要执行的 SQL SELECT 查询。"
    }
  },
  "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>