MCP-сервер для PostgreSQL

Реализация сервера Model Context Protocol (MCP) для PostgreSQL, предоставляющая простой интерфейс для взаимодействия с базами данных PostgreSQL через MCP.

Функции

Выполнение SQL-запросов с параметризованными входными данными
Выполнение операций INSERT/UPDATE/DELETE
Создать новые базы данных
Создание или обновление схем таблиц
Отладка соединений PostgreSQL
Контейнеризация с Docker для простоты развертывания
Конфигурация на основе среды

Предпосылки

Питон 3.8+
PostgreSQL 10+
Docker (опционально, для контейнерного развертывания)
Docker Compose (опционально, для разработки)

Установка

Использование Docker (рекомендуется)

Клонируйте репозиторий:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres
Скопируйте пример файла среды:
cp .env.example .env
Обновите файл .env , указав свои учетные данные PostgreSQL:
PG_HOST=postgres PG_PORT=5432 PG_USER=postgres PG_PASSWORD=your_password PG_DATABASE=your_database HOST=0.0.0.0 PORT=8056
Запустите службу с помощью Docker Compose:
docker-compose up -d

Ручная установка

Клонируйте репозиторий:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres
Создайте и активируйте виртуальную среду:
python -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate
Установить зависимости:
pip install -r requirements.txt
Скопируйте пример файла среды и обновите его:
cp .env.example .env # Edit .env with your configuration
Запускаем сервер:
python mcp_server_postgres.py

Использование

Сервер MCP предоставляет следующие конечные точки:

`sql_query`

Выполнить запрос SELECT и вернуть результаты в формате JSON.

Параметры:

query : строка запроса SQL
params : Необязательная строка JSON параметров запроса (список или словарь)

Пример:

{
  "query": "SELECT * FROM users WHERE id = $1",
  "params": [1]
}

`sql_execute`

Выполните оператор INSERT/UPDATE/DELETE.

Параметры:

query : SQL-выражение
params : Необязательная строка JSON параметров запроса (список или словарь)

Пример:

{
  "query": "INSERT INTO users (name, email) VALUES ($1, $2)",
  "params": ["John Doe", "john@example.com"]
}

`create_database`

Создайте новую базу данных PostgreSQL.

Параметры:

database_name : Имя создаваемой базы данных

`create_or_update_table`

Создайте или обновите схему таблицы.

Параметры:

sql : SQL-оператор CREATE TABLE или ALTER TABLE

`debug_postgres_connection`

Отладка соединения PostgreSQL.

Переменные среды

Переменная	По умолчанию	Описание
PG_HOST	локальный хост	Хост PostgreSQL
PG_PORT	5432	Порт PostgreSQL
PG_USER	постгрес	Имя пользователя PostgreSQL
PG_ПАРОЛЬ		Пароль PostgreSQL
PG_DATABASE	постгрес	Имя базы данных по умолчанию
ХОЗЯИН	0.0.0.0	Хост для привязки сервера MCP
ПОРТ	8056	Порт для запуска сервера MCP

Разработка

Проведение тестов

# Install test dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

Создание образа Docker

docker build -t mcp-server-postgres .

API-документация

Подробную документацию по API можно найти в спецификации OpenAPI .

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

FastMCP — серверная платформа MCP
asyncpg — клиент PostgreSQL для Python
FastAPI — современный, быстрый веб-фреймворк для создания API

This server cannot be installed

security - not tested

license - not found

quality - not tested

Реализация сервера Model Context Protocol, которая предоставляет простой интерфейс для взаимодействия с базами данных PostgreSQL, позволяя выполнять SQL-запросы, операции с базами данных и управлять схемами через MCP.

Related MCP Servers

Enhanced PostgreSQL MCP Server
GarethCott
-
security
F
license
-
quality
A Model Context Protocol server providing both read and write access to PostgreSQL databases, enabling LLMs to query data, modify records, and manage database schemas.
Last updated -
4
JavaScript
PostgreSQL MCP Server
HenkDz
-
security
A
license
-
quality
A Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.
Last updated -
355
46
TypeScript
AGPL 3.0
Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP PostgreSQL Server
a21071
-
security
F
license
-
quality
A Model Context Protocol server that enables performing PostgreSQL database operations (create, read, update, delete) on User and Post entities through MCP tools.
Last updated -
TypeScript

View all related MCP servers

MCP Server for PostgreSQL