MCP 服务器：PostgreSQL Docker 初始化器

本项目实现了一个模型上下文协议 (MCP) 服务器，该服务器提供一个工具来初始化运行在新的 Docker 容器内的 PostgreSQL 数据库。

该服务器公开了一个工具 init-postgres-docker，它接受一个数据库名称作为输入，并执行以下操作：

• 如果 postgres:latest Docker 镜像不存在，则拉取该镜像。
• 创建一个新的运行 PostgreSQL 的 Docker 容器。
• 使用指定的数据库名称 (dbName)、默认用户 (pguser) 和默认密码 (mysecretpassword - 注意：这是不安全的，仅用于演示目的) 配置容器。
• 将容器的内部端口 5432 映射到主机上的一个随机可用端口。
• 设置容器在停止时自动删除 (AutoRemove: true)。
• 返回一个成功消息，其中包括 PostgreSQL 连接 URL（例如，postgresql://pguser:mysecretpassword@localhost:<hostPort>/<dbName>）。

前提条件

• Node.js 和 npm（或兼容的包管理器）
• Docker（必须正在运行）
• Make

使用 Makefile

提供了一个 Makefile 用于常见任务。 从该项目的根目录 (mcp-server-postgres-init) 运行以下命令：

• 安装依赖:

  make install
  

  (运行 npm install)

• 构建项目:

  make build
  

  (运行 npm run build，它将 TypeScript 编译为 build/ 目录中的 JavaScript)

• 检查服务器:

  make inspect
  

  (首先运行 make build，然后使用 npx @modelcontextprotocol/inspector node build/index.js 启动 MCP 检查器。 然后，您可以向 init-postgres-docker 工具发送请求。)

• 安装、构建和检查 (默认):

  make
  

  或

  make all
  

  (依次运行 make install、make build 和 make inspect)

• 清理项目:

  make clean
  

  (删除 node_modules、build 和 *.tsbuildinfo 文件)

手动运行

如果您不想使用 Make：

1. 安装依赖: npm install
2. 构建项目: npm run build
3. 运行服务器（例如，使用检查器）：

   npx @modelcontextprotocol/inspector node build/index.js
   

   或者，如果使用客户端连接，则直接运行服务器：

   node build/index.js
   

重要提示

• Docker 必须正在运行： Docker 守护程序需要处于活动状态，此服务器才能创建容器。
• 密码安全： 默认密码 (mysecretpassword) 是硬编码的，不安全。 对于实际使用，请实施更安全的密码处理方法（例如，生成、环境变量）。
• 资源管理： 容器设置为自动删除。 考虑您的用例所需的生命周期。