Postgres MCP（研究项目）

这是一个针对PostgreSQL数据库的Model Control Protocol (MCP)服务器实现。该项目提供了一个简单的HTTP接口，通过MCP与PostgreSQL数据库进行交互，允许执行只读查询并探索数据库资源。

特性

• 符合MCP标准的HTTP服务器
• 执行只读SQL查询
• 列出数据库资源
• 通过.env文件支持环境变量
• 使用Go和Gin Web框架构建

预备条件

• Go 1.23.6或更高版本
• PostgreSQL数据库
• Git

安装

git clone https://github.com/ipfans/postgres-mcp.git
cd postgres-mcp
go mod download

配置

你可以通过两种方式配置数据库连接：

1. 使用命令行标志：

go run cmd/postgres-mcp/main.go -db "postgres://user:password@localhost:5432/dbname"

2. 使用环境变量：
   • 在项目根目录创建一个.env文件
   • 添加你的数据库URL：

     DATABASE_URL=postgres://user:password@localhost:5432/dbname
     

使用方法

1. 启动服务器：

go run cmd/postgres-mcp/main.go

默认情况下，服务器将在8080端口启动。

2. 与MCP端点交互：

• 列出数据库资源：

  POST http://localhost:8080/mcp
  Content-Type: application/json
  
  {
    "type": "function",
    "name": "resources"
  }
  

• 执行只读查询：

  POST http://localhost:8080/mcp
  Content-Type:  application/json
  
  {
    "type": "function",
    "name": "query",
    "arguments": {
      "query": "SELECT * FROM your_table LIMIT 10"
    }
  }
  

许可证

本项目是开源的，并在MIT许可证下可用。

贡献

欢迎贡献！请随时提交Pull Request。