MEC Postgres

🚀 MEC PostgreSQL 服务器

MEC PostgreSQL 服务器是一个模型上下文协议（Model Context Protocol）服务器，它提供了对 PostgreSQL 数据库的读写访问能力。借助该服务器，大型语言模型（LLM）能够检查数据库架构，并执行读取和写入查询操作。

🚀 快速开始

若要使用此服务器与 Claude Desktop 应用，需将以下配置添加到 claude_desktop_config.json 文件中的 "mcpServers" 部分：

Docker

• 当在 macOS 上运行 docker 时，请使用 host.docker.internal 如果服务器运行在主机网络（例如 localhost）。
• 用户名/密码可以添加到 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"]
    }
  }
}

请将 /mydb 替换为您的数据库名称。

✨ 主要特性

• 提供对 PostgreSQL 数据库的读写访问。
• 支持大型语言模型（LLM）检查数据库架构并执行查询。
• 提供每个表的架构信息。

📦 安装指南

Docker 构建

使用以下命令构建 Docker 镜像：

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

💻 使用示例

工具使用

query

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

uploadCsv

• 功能：上传并处理 CSV 文件到数据库表中。
• 输入：sql (字符串)：要执行的 SQL 查询。
• 说明：所有查询都在 READ AND WRITE（读写）事务中执行。

资源获取

该服务器提供每个表的架构信息，可通过以下链接获取：

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

📚 详细文档

使用 Claude Desktop 注意事项

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

配置文件说明

在 claude_desktop_config.json 文件的 "mcpServers" 部分添加如下配置：

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

需将 /mydb 替换为您的数据库名称。

📄 许可证

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