🚀 PostgreSQL

一个提供只读访问的Model Context Protocol服务器，用于连接PostgreSQL数据库。该服务器允许大语言模型（LLM）检查数据库模式并执行只读查询。

🚀 快速开始

本服务器允许大语言模型（LLM）对PostgreSQL数据库进行只读访问，可检查数据库模式并执行只读查询。下面将为你介绍使用方法及相关配置。

✨ 主要特性

工具

• query
  • 执行针对连接到数据库的只读SQL查询。
  • 输入：sql (字符串)：要执行的SQL查询。
  • 所有查询均在 READ ONLY 事务中执行。

资源

该服务器为每个数据库表提供模式信息：

• 表格模式 (postgres://<主机>/<table>/schema)
  • 每个表的JSON模式信息。
  • 包括列名和数据类型。
  • 从数据库元数据中自动发现。

📦 安装指南

Docker

docker build -t mcp/postgres -f src/postgres/Dockerfile .

💻 使用示例

与Claude Desktop应用程序配合使用

要与Claude Desktop应用程序一起使用此服务器，请将以下配置添加到claude_desktop_config.json文件中的"mcpServers"部分：

Docker配置

⚠️ 重要提示

• 当在macOS上运行Docker时，如果服务器在主机网络上运行（例如localhost），请使用host.docker.internal。
• 用户名/密码可以通过PostgreSQL URL中的postgresql://user:password@host:port/db-name添加到PostgreSQL URL中。

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"
      ]
    }
  }
}

NPX配置

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

请将/mydb替换为你的数据库名称。

📄 许可证

此MCP服务器根据MIT License授权。这意味着你可以自由使用、修改和分发软件，但需遵守MIT License的条款和条件。更多细节，请参阅项目仓库中的LICENSE文件。