-
securityF
license-
qualityA 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 -
583
7
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: строка запроса SQLparams: Необязательная строка 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 .
Благодарности
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Реализация сервера Model Context Protocol, которая предоставляет простой интерфейс для взаимодействия с базами данных PostgreSQL, позволяя выполнять SQL-запросы, операции с базами данных и управлять схемами через MCP.
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -181,016119AGPL 3.0
- -securityFlicense-qualityA Model Context Protocol server that enables performing PostgreSQL database operations (create, read, update, delete) on User and Post entities through MCP tools.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that enables interaction with PostgreSQL databases to list tables, retrieve schemas, and execute read-only SQL queries.Last updated -26MIT License