MCP Postgres Server

@MadeByNando

About MCP Postgres Server

No overview available yet

#mcp-postgres-server #postgresql #database

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-postgres-server-madebynando": {
      "command": "docker",
      "args": [
        "logs",
        "mcp-postgres-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Postgres Server?

MCP Postgres Server implements the Model Context Protocol (MCP) for Cursor, letting you use a PostgreSQL database as storage for model contexts. It is designed for developers who want to securely query and explore PostgreSQL databases directly from Cursor.

How to use MCP Postgres Server?

Clone the repository and start the server with Docker Compose (docker-compose up -d). Then configure a new MCP connection in Cursor (Settings > MCP) using the command docker exec -i mcp-postgres-server node dist/index.js.

Key features of MCP Postgres Server

Runs PostgreSQL as MCP storage via Docker.
Exposes three tools: query, list tables, describe table.
postgres_query executes read-only SQL queries.
postgres_list_tables lists all database tables.
postgres_describe_table returns a table’s schema.
Enables secure database exploration from Cursor.

Use cases of MCP Postgres Server

Querying a PostgreSQL database directly from Cursor’s agent.
Listing tables and inspecting schemas during development.
Integrating database context into AI‑assisted coding workflows.
Troubleshooting database structure without leaving the editor.

FAQ from MCP Postgres Server

What are the prerequisites to run MCP Postgres Server?

Docker and Docker Compose must be installed on your system.

How do I configure MCP Postgres Server in Cursor?

In Cursor, go to Settings > MCP, add a new connection with the command docker exec -i mcp-postgres-server node dist/index.js.

What tools does MCP Postgres Server expose?

It exposes three tools: postgres_query (read-only SQL), postgres_list_tables (list all tables), and postgres_describe_table (describe a table’s schema).

Is the query tool safe for production databases?

Yes, postgres_query is explicitly read-only, so it cannot modify data.

How do I troubleshoot if the server fails to start?

Check the container logs with docker logs mcp-postgres-server or restart the server with docker-compose restart.

Frequently asked questions

What are the prerequisites to run MCP Postgres Server?

Docker and Docker Compose must be installed on your system.

How do I configure MCP Postgres Server in Cursor?

In Cursor, go to Settings > MCP, add a new connection with the command `docker exec -i mcp-postgres-server node dist/index.js`.

What tools does MCP Postgres Server expose?

It exposes three tools: `postgres_query` (read-only SQL), `postgres_list_tables` (list all tables), and `postgres_describe_table` (describe a table’s schema).