MEC PostgreSQL

MEC PostgreSQL

site icon
2025.04.16 0
JavaScript数据库访问工具PostgreSQL 接口数据库
MEC PostgreSQL 是一个基于 Model Context Protocol 的服务器,提供对 PostgreSQL 数据库的读写访问能力。该服务器使 LLMs(大型语言模型)能够检查数据库模式并执行读写查询。
View on GitHub

Overview

基本能力

产品定位

MEC PostgreSQL 是一个数据库访问工具,专门为 LLMs 提供与 PostgreSQL 数据库交互的能力。

核心功能

  1. 查询功能
  2. 执行只读 SQL 查询
  3. 所有查询在 READ ONLY 事务中执行
  4. 上传 CSV 文件
  5. 上传并处理 CSV 文件到数据库表
  6. 所有操作在 READ AND WRITE 事务中执行
  7. 资源提供
  8. 自动发现数据库元数据
  9. 提供表结构的 JSON 模式信息,包括列名和数据类型

适用场景

  1. LLMs 需要访问 PostgreSQL 数据库进行数据查询
  2. 需要将 CSV 数据批量导入 PostgreSQL 数据库
  3. 需要获取数据库表结构信息

工具列表

  1. query
  2. 能力:执行只读 SQL 查询
  3. 输入:SQL 查询字符串
  4. uploadCsv
  5. 能力:上传并处理 CSV 文件到数据库表
  6. 输入:SQL 查询字符串

常见问题解答

  1. Docker 在 macOS 上的使用
  2. 如果服务器运行在主机网络上(如 localhost),使用 host.docker.internal
  3. 用户名和密码
  4. 可以通过 postgresql://user:password@host:port/db-name 格式添加到 PostgreSQL URL 中

使用教程

使用依赖

  1. 确保已安装 Docker
  2. 确保 PostgreSQL 数据库已安装并可访问

安装教程

  1. 构建 Docker 镜像:
docker build -t mcp/postgres -f src/postgres/Dockerfile .
  1. 配置 Claude Desktop:
{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

调试方式

  1. 检查 Docker 容器是否正常运行
  2. 验证 PostgreSQL 连接字符串是否正确
  3. 检查 Claude Desktop 配置是否正确

许可证

该项目遵循 MIT 开源许可条款。