MCP Server for PostgreSQL

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

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

Функции

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

Предпосылки

• Питон 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