PostgreSQL MCP 服务器 (增强版)

一个模型上下文协议服务器，提供对 PostgreSQL 数据库的读写访问。该服务器使 LLM 能够检查数据库模式、执行查询、修改数据以及创建/修改数据库模式对象。

注意： 这是 Anthropic 提供的原始 PostgreSQL MCP 服务器 的增强版本。原始服务器提供只读访问，而此增强版本增加了写入功能和模式管理。

组件

工具

数据查询

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

数据修改

• execute

  • 执行修改数据的 SQL 语句 (INSERT, UPDATE, DELETE)
  • 输入：sql (字符串): 要执行的 SQL 语句
  • 在具有适当 COMMIT/ROLLBACK 处理的事务中执行

• insert

  • 将新记录插入到表中
  • 输入：
    • table (字符串): 表名
    • data (对象): 键值对，其中键是列名，值是要插入的数据

• update

  • 更新表中的记录
  • 输入：
    • table (字符串): 表名
    • data (对象): 要更新的字段的键值对
    • where (字符串): 用于标识要更新的记录的 WHERE 条件

• delete

  • 从表中删除记录
  • 输入：
    • table (字符串): 表名
    • where (字符串): 用于标识要删除的记录的 WHERE 条件

模式管理

• createTable

  • 创建具有指定列和约束的新表
  • 输入：
    • tableName (字符串): 表名
    • columns (数组): 包含名称、类型和可选约束的列定义数组
    • constraints (数组): 可选的表级约束数组

• createFunction

  • 创建 PostgreSQL 函数/过程
  • 输入：
    • name (字符串): 函数名
    • parameters (字符串): 函数参数
    • returnType (字符串): 返回类型
    • language (字符串): 语言 (plpgsql, sql, 等)
    • body (字符串): 函数体
    • options (字符串): 可选的附加函数选项

• createTrigger

  • 在表上创建触发器
  • 输入：
    • name (字符串): 触发器名称
    • tableName (字符串): 应用触发器的表
    • functionName (字符串): 要调用的函数
    • when (字符串): BEFORE, AFTER, 或 INSTEAD OF
    • events (数组): 事件数组 (INSERT, UPDATE, DELETE)
    • forEach (字符串): ROW 或 STATEMENT
    • condition (字符串): 可选的 WHEN 条件

• createIndex

  • 在表上创建索引
  • 输入：
    • tableName (字符串): 表名
    • indexName (字符串): 索引名称
    • columns (数组): 要索引的列
    • unique (布尔值): 索引是否唯一
    • type (字符串): 可选的索引类型 (BTREE, HASH, GIN, GIST, 等)
    • where (字符串): 可选的条件

• alterTable

  • 更改表结构
  • 输入：
    • tableName (字符串): 表名
    • operation (字符串): 操作 (ADD COLUMN, DROP COLUMN, 等)
    • details (字符串): 操作详情

资源

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

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

与 Claude Desktop 一起使用

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

Docker

• 在 macos 上运行 docker 时，如果服务器在主机网络（例如 localhost）上运行，请使用 host.docker.internal
• 可以使用 postgresql://user:password@host:port/db-name 将用户名/密码添加到 postgresql url
• 如果需要绕过 SSL 证书验证，请添加 ?sslmode=no-verify

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

使用示例

查询数据

/query SELECT * FROM users LIMIT 5

插入数据

/insert table="users", data={"name": "John Doe", "email": "john@example.com"}

更新数据

/update table="users", data={"status": "inactive"}, where="id='123'"

创建表

/createTable tableName="tasks", columns=[
  {"name": "id", "type": "SERIAL", "constraints": "PRIMARY KEY"}, 
  {"name": "title", "type": "VARCHAR(100)", "constraints": "NOT NULL"},
  {"name": "created_at", "type": "TIMESTAMP", "constraints": "DEFAULT CURRENT_TIMESTAMP"}
]

创建函数和触发器

/createFunction name="update_timestamp", parameters="", returnType="TRIGGER", language="plpgsql", body="BEGIN NEW.updated_at = NOW(); RETURN NEW; END;"

/createTrigger name="set_timestamp", tableName="tasks", functionName="update_timestamp", when="BEFORE", events=["UPDATE"], forEach="ROW"

构建

Docker:

docker build -t mcp/postgres -f Dockerfile . 

安全注意事项

1. 所有数据修改操作都使用具有适当 COMMIT/ROLLBACK 处理的事务
2. 每个操作都返回执行的 SQL，以提高透明度
3. 服务器对 insert/update 操作使用参数化查询，以防止 SQL 注入

许可证

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