PostgreSQL

PostgreSQL

site icon
2025.03.19 1
JavaScript数据库服务只读访问数据库
PostgreSQL MCP服务器是一个基于模型上下文协议(Model Context Protocol)的服务,提供对PostgreSQL数据库的只读访问。该服务允许LLMs(大型语言模型)检查数据库模式并执行只读查询。
View on GitHub

Overview

基本能力

产品定位

PostgreSQL MCP服务器旨在为大型语言模型提供对PostgreSQL数据库的只读访问能力,使其能够查询数据库模式和执行只读SQL查询。

核心功能

  • 只读查询:通过query工具执行只读SQL查询,所有查询都在只读事务中执行。
  • 模式检查:自动发现数据库元数据,提供表结构的JSON模式信息,包括列名和数据类型。

适用场景

  • 数据库模式检查和分析
  • 只读数据查询和报告生成
  • 与大型语言模型集成,增强其对数据库的理解能力

工具列表

  • query:执行只读SQL查询,输入为SQL查询字符串。

常见问题解答

  • Docker使用问题:在macOS上运行时,如果服务器运行在主机网络上(如localhost),应使用host.docker.internal作为主机名。
  • 认证问题:可以在PostgreSQL URL中添加用户名和密码,格式为postgresql://user:password@host:port/db-name

使用教程

使用依赖

  • 确保已安装Docker或Node.js(使用NPX方式时)。

安装教程

Docker方式

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

NPX方式

无需安装,直接通过npx运行。

调试方式

  • 确保PostgreSQL数据库可访问,并且URL配置正确。
  • 使用提供的JSON配置示例测试与Claude Desktop应用的集成。

许可证

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