返回 MCP 目录
public公开dns本地运行

simple-postgres-mcp

一个简单的PostgreSQL MCP服务器,用于执行SQL查询并支持可配置的读写权限。

article

README

🚀 简单的PostgreSQL MCP服务器

这是一个轻量级的模型上下文协议(MCP)服务器,用于在PostgreSQL数据库上执行SQL查询,并且具备可配置的权限。

✨ 主要特性

  • 可执行SQL查询,支持可选的只读或写入访问。
  • 可通过命令行配置服务器级别的模式(只读/写入)。
  • 返回带有元数据的结构化结果。
  • 使用PostgreSQL连接字符串即可轻松完成设置。

🚀 快速开始

📦 安装指南

  1. 克隆仓库
    git clone https://github.com/perrypixel/Simple-Postgres-MCP
    cd Simple-Postgres-MCP
    
  2. 安装依赖
    npm install
    
  3. 构建项目
    npm run build
    

📚 详细文档

MCP配置

将以下内容添加到您的MCP客户端配置文件(mcp.json)中:

写入模式(默认)
{
  "mcpServers": {
    "simple-postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/build/index.js",
        "postgresql://username:password@localhost:5432/database_name",
        "write"
      ]
    }
  }
}
只读模式
{
  "mcpServers": {
    "simple-postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/build/index.js",
        "postgresql://username:password@localhost:5432/database_name",
        "readonly"
      ]
    }
  }
}

⚠️ 重要提示

请更新配置中的路径,使其指向您build文件夹内的index.js文件。

💻 使用示例

  1. 将合适的MCP配置(只读或写入模式)复制到您工具的mcp.json文件中(例如Cursor、Windsurf、Copilot等)。
  2. 启动您的MCP客户端,此时服务器即可使用!

🤝 支持项目

如果您觉得这个工具很有用,可以通过以下方式支持开发:

  • 在https://ko-fi.com/perrypixel 请我喝杯咖啡。
  • 通过UPI转账至kevinp@apl。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端