PostgreSQL

基本能力

产品定位

PostgreSQL MCP服务器旨在为LLMs提供对PostgreSQL数据库的只读访问能力，使其能够检查数据库模式和执行只读查询。

核心功能

• 只读查询：执行只读SQL查询，所有查询都在只读事务中执行。
• 模式检查：提供数据库中每个表的JSON模式信息，包括列名和数据类型。

适用场景

• 数据库模式检查
• 只读数据查询
• 数据库元数据自动发现

工具列表

• query
• 能力：对连接的数据库执行只读SQL查询
• 输入：sql（字符串）：要执行的SQL查询

常见问题解答

• 在macOS上运行Docker时，如果服务器运行在主机网络上（如localhost），请使用host.docker.internal作为主机名。
• 用户名和密码可以通过URL格式添加到PostgreSQL连接字符串中：postgresql://user:password@host:port/db-name

使用教程

使用依赖

• Docker或NPX

安装教程

Docker安装

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

NPX安装

无需安装，直接使用npx命令运行。

调试方式

Docker配置示例

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。