AI导哈

PostgreSQL数据库协议服务器

一个提供对PostgreSQL数据库读写访问的模型上下文协议服务器，支持数据库模式检查、查询执行、数据修改和模式对象管理。

  • by GarethCott
  • JavaScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 GarethCott/enhanced-postgres-mcp-server

使用说明

PostgreSQL MCP服务器（增强型）

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

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

组件

工具

数据查询

  • 怎么翻译
    • 对连接的数据库执行只读SQL查询
    • 输入： sql （string）：要执行的SQL查询
    • 所有查询都在只读事务中执行

数据修改

  • 执行

    • 执行修改数据的SQL语句（INSERT、UPDATE、DELETE）
    • 输入： sql （string）：要执行的SQL语句
    • 在具有适当COMMIT/ROLLBACK处理的事务中执行

  • 插入

    • 将新记录插入表中
    • 输入：
      • table （string）：表名
      • data （object）：键值对，其中键是列名，值是要插入的数据

  • 更新

    • 更新表中的记录
    • 输入：
      • table （string）：表名
      • data （object）：要更新的字段的键值对
      • where （string）：用于标识要更新的记录的WHERE条件

  • 删除

    • 从表中删除记录
    • 输入：
      • table （string）：表名
      • where （string）：用于标识要删除的记录的WHERE条件

模式管理

  • createTable

    • 使用指定的列和约束创建新表
    • 输入：
      • tableName （string）：表名
      • columns （array）：具有名称、类型和可选约束的列定义数组
      • constraints （array）：表级约束的可选数组

  • createFunction

    • 创建PostgreSQL函数/过程
    • 输入：
      • name （string）：函数名称
      • parameters （string）：函数参数
      • returnType （string）：返回类型
      • language （string）：语言（plpgsql、sql等）
      • body （string）：函数体
      • options （string）：可选附加功能选项

  • createTrigger

    • 在桌子上创建触发器
    • 输入：
      • name （string）：触发器名称
      • tableName （string）：应用触发器的表
      • functionName （string）：要调用的函数
      • when （string）：之前、之后或代替
      • events （array）：事件数组（INSERT、UPDATE、DELETE）
      • forEach （string）：ROW或STATEMENT
      • condition （string）：可选WHEN条件

  • 创建指数

    • 在表上创建索引
    • 输入：
      • tableName （string）：表名
      • indexName （string）：索引名称
      • columns （数组）：要索引的列
      • unique （boolean）：索引是否唯一
      • type （string）：可选索引类型（BTREE、HASH、GIN、GIST等）
      • where （string）：可选条件

  • alterTable

    • 更改表结构
    • 输入：
      • tableName （string）：表名
      • operation （string）：操作（添加列、删除列等）
      • details （string）：操作细节

资源

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

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

使用Claude Desktop

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

码头工人

  • 在macos上运行docker时，如果服务器在主机网络上运行（例如localhost），请使用host.docker.internal
  • 用户名/密码可以添加到postgresql url中 postgresql://user:password@host:port/db-name
  • 添加 ?sslmode=no-verify 如果您需要绕过SSL证书验证
{
  "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. 服务器使用参数化查询进行插入/更新操作，以防止SQL注入
  4. 安全修复程序（v1.0.2）：只读查询工具现在使用预处理语句来防止SQL注入攻击，这些攻击可以通过执行多个语句来绕过事务隔离

许可证

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

相关 MCP