MCP PostgreSQL 服务器

-<img src="assets/logo.svg" width="256" height="256" alt="MCP Postgres Logo" />

一个模型上下文协议 (MCP) 服务器，通过 MCP 工具提供 PostgreSQL 数据库操作。

功能特性

• 用户和帖子实体的 CRUD 操作
• 使用 Prisma 的类型安全数据库操作
• 兼容 MCP 的工具接口
• 使用 TypeScript 构建，保证类型安全

安装

1. 克隆仓库
2. 安装依赖:

git clone https://github.com/a21071/mcp-postgres.git
cd mcp-postgres
npm install

3. 设置 PostgreSQL 数据库:

docker-compose up -d

4. 运行数据库迁移:

npx prisma migrate dev

5. 构建项目:

npm run build

使用方法

运行服务器:

npm start

可用的 MCP 工具

• getData: 从 PostgreSQL 检索用户数据

  {
    "tableName": "user"
  }
  

• addUserData: 向数据库添加新用户

  {
    "email": "user@example.com",
    "name": "John Doe",
    "age": 30
  }
  

• deleteUserData: 通过 ID、电子邮件或名称删除用户

  {
    "id": "clxyz...",
    "email": "user@example.com",
    "name": "John Doe"
  }
  

• updateUserData: 更新用户信息

  {
    "id": "clxyz...",
    "email": "new@example.com",
    "name": "New Name"
  }
  

数据库 Schema

服务器使用以下 Prisma schema:

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  name      String?
  age       Int?
  createdAt DateTime @default(now())
  posts     Post[]
}

开发

• 监听模式:

npm run watch

依赖项

• @modelcontextprotocol/sdk - MCP 服务器 SDK
• Prisma - 类型安全的数据库客户端
• TypeScript - 类型检查

许可证

MIT