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

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

Функции

• Выполнение SQL-запросов с параметризованными входными данными

• Выполнение операций INSERT/UPDATE/DELETE

• Создать новые базы данных

• Создание или обновление схем таблиц

• Отладка соединений PostgreSQL

• Контейнеризация с Docker для простоты развертывания

• Конфигурация на основе среды

Related MCP server: PostgreSQL MCP Server

Предпосылки

• Питон 3.8+

• PostgreSQL 10+

• Docker (опционально, для контейнерного развертывания)

• Docker Compose (опционально, для разработки)

Установка

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

1. Клонируйте репозиторий:

   git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres

2. Скопируйте пример файла среды:

   cp .env.example .env

3. Обновите файл .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

4. Запустите службу с помощью Docker Compose:

   docker-compose up -d

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

1. Клонируйте репозиторий:

   git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres

2. Создайте и активируйте виртуальную среду:

   python -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate

3. Установить зависимости:

   pip install -r requirements.txt

4. Скопируйте пример файла среды и обновите его:

   cp .env.example .env # Edit .env with your configuration

5. Запускаем сервер:

   python mcp_server_postgres.py

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

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

sql_query

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

Параметры:

• query : строка запроса SQL

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

Пример:

sql_execute

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

Параметры:

• query : SQL-выражение

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

Пример:

create_database

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

Параметры:

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

create_or_update_table

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

Параметры:

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

debug_postgres_connection

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

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

Разработка

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

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

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

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

Внося вклад

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

Лицензия

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

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

• FastMCP — серверная платформа MCP

• asyncpg — клиент PostgreSQL для Python

• FastAPI — современный, быстрый веб-фреймворк для создания API