README

MCP PostgreSQL Server

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

A Model Context Protocol (MCP) server that provides PostgreSQL database operations through MCP tools.

Features

CRUD operations for User and Post entities
Type-safe database operations using Prisma
MCP-compatible tool interface
Built with TypeScript for type safety

Installation

Clone the repository
Install dependencies:

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

Set up PostgreSQL database:

docker-compose up -d

Run database migrations:

npx prisma migrate dev

Build the project:

npm run build

Usage

Run the server:

npm start

Available MCP Tools

getData: Retrieve user data from PostgreSQL
```
{
  "tableName": "user"
}
```

addUserData: Add new user to database

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

deleteUserData: Delete user by ID, email or name

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

updateUserData: Update user information

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

Database Schema

The server uses the following Prisma schema:

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

Development

Watch mode:

npm run watch

Dependencies

@modelcontextprotocol/sdk - MCP server SDK
Prisma - Type-safe database client
TypeScript - Type checking

License

MIT

MCP PostgreSQL Server

README

MCP PostgreSQL Server

Features

Installation

Usage

Available MCP Tools

Database Schema

Development

Dependencies

License

Recommended Servers