Для чего этот сервер?

Сервер подключает ИИ-агенты к PostgreSQL: они могут выполнять SQL-запросы, изучать схему, описания таблиц, индексы и производительность. Всё это без риска случайно изменить данные — по умолчанию доступно только чтение. Разработчики и аналитики получают быстрый доступ к базе через привычный интерфейс ассистента, а не через терминал или админку.

Каталог MCP
JaviMaligno/postgres_mcp

JaviMaligno/postgres_mcp

от javimaligno

MCP сервер для работы с PostgreSQL: выполняет SQL-запросы, исследует схемы, таблицы и индексы, помогает с производительностью через EXPLAIN. Работает read-only по умолчанию — безопасность на первом месте. Подходит для Claude Desktop, Cursor и других MCP-клиентов.

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

PostgreSQL MCP Server

MCP server for PostgreSQL database operations. Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Language Versions

This repository contains both TypeScript and Python implementations:

Version	Directory	Status	MCP protocol	Installation
TypeScript	`/typescript`	✅ Recommended (Smithery)	`2026-07-28` (SDK v2)	`npm install -g @javiagui/postgresql-mcp`
Python	`/python`	✅ Stable	`2026-07-28` (SDK v2)	`pipx install postgresql-mcp`

Note: The TypeScript version is used for Smithery deployments. Both versions provide identical functionality.

Protocol compatibility: both servers speak the 2026-07-28 revision and are dual-era — clients that still open with the 2025-era initialize handshake are served exactly as before, so no client needs upgrading. The TypeScript package requires Node.js 20+; the Python package requires Python 3.10+.

Features

Query Execution: Execute SQL queries with read-only protection by default
Schema Exploration: List schemas, tables, views, and functions
Table Analysis: Describe structure, indexes, constraints, and statistics
Performance Tools: EXPLAIN queries and analyze table health
Security First: SQL injection prevention, credential protection, read-only by default
MCP Prompts: Guided workflows for exploration, query building, and documentation
MCP Resources: Browsable database structure as markdown

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`1.0.1`основная	09.02.2026
`1.0.0`	09.02.2026

Выберите клиент, чтобы установить JaviMaligno/postgres_mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"javimaligno-postgresmcp-sr5jjmfrhk\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"postgresql-mcp\"],\"env\":{\"POSTGRES_HOST\":\"localhost\",\"POSTGRES_PORT\":\"5432\",\"POSTGRES_USER\":\"your_user\",\"POSTGRES_PASSWORD\":\"your_password\",\"POSTGRES_DB\":\"your_database\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add javimaligno-postgresmcp-sr5jjmfrhk --env POSTGRES_HOST=localhost --env POSTGRES_PORT=5432 --env POSTGRES_USER=your_user --env POSTGRES_PASSWORD=your_password --env POSTGRES_DB=your_database -- npx postgresql-mcp

Либо через JSON-конфиг:

claude mcp add-json javimaligno-postgresmcp-sr5jjmfrhk "{\"command\":\"npx\",\"args\":[\"postgresql-mcp\"],\"env\":{\"POSTGRES_HOST\":\"localhost\",\"POSTGRES_PORT\":\"5432\",\"POSTGRES_USER\":\"your_user\",\"POSTGRES_PASSWORD\":\"your_password\",\"POSTGRES_DB\":\"your_database\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add javimaligno-postgresmcp-sr5jjmfrhk --env POSTGRES_HOST=localhost --env POSTGRES_PORT=5432 --env POSTGRES_USER=your_user --env POSTGRES_PASSWORD=your_password --env POSTGRES_DB=your_database -- npx postgresql-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.javimaligno-postgresmcp-sr5jjmfrhk]
command = "npx"
args = ["postgresql-mcp"]

[mcp_servers.javimaligno-postgresmcp-sr5jjmfrhk.env]
POSTGRES_HOST = "localhost"
POSTGRES_PORT = "5432"
POSTGRES_USER = "your_user"
POSTGRES_PASSWORD = "your_password"
POSTGRES_DB = "your_database"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите JaviMaligno/postgres_mcp, а в поле команды запуска — строку ниже:

npx postgresql-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например javimaligno-postgresmcp-sr5jjmfrhk.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: javimaligno-postgresmcp-sr5jjmfrhk
    command: npx
    args:
      - "postgresql-mcp"
    env:
      POSTGRES_HOST: localhost
      POSTGRES_PORT: 5432
      POSTGRES_USER: your_user
      POSTGRES_PASSWORD: your_password
      POSTGRES_DB: your_database

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "javimaligno-postgresmcp-sr5jjmfrhk": {
      "command": "npx",
      "args": [
        "postgresql-mcp"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "your_user",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_DB": "your_database"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "postgresql-mcp"
  ],
  "env": {
    "POSTGRES_HOST": "localhost",
    "POSTGRES_PORT": "5432",
    "POSTGRES_USER": "your_user",
    "POSTGRES_PASSWORD": "your_password",
    "POSTGRES_DB": "your_database"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx