PostgreSQL 模型上下文协议（Model Context Protocol）服务器

这是一个为PostgreSQL数据库提供只读访问的模型上下文协议服务器。该服务器使大型语言模型（LLMs）能够查看数据库架构并执行只读查询。

组件

工具

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

资源

该服务器提供每个表的架构信息：

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

使用 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

{
  "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 替换为您的数据库名称。

构建

Docker：

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

许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目存储库中的 LICENSE 文件。