Simple PostgreSQL MCP Server
Шаблон для создания простого MCP-сервера с подключением к PostgreSQL для взаимодействия AI с базами данных.
Описание
Это шаблон на Python для новичков, реализующий MCP-сервер для PostgreSQL. Позволяет LLMs выполнять SQL-запросы (инструменты), получать схемы таблиц (ресурсы) и использовать шаблоны промптов для генерации запросов. Технологии: Python 3.8+, uv, npx, PostgreSQL. Идеально для экспериментов с AI-коннекторами, анализа данных в БД через естественный язык, создания плагинов для инструментов вроде Claude Desktop. Легко расширяется для новых серверов.
Возможности
Инструменты (Tools)
Выполнение SQL-запросов (`execute_query`) и проверка подключения (`test_connection`) к PostgreSQL.
Ресурсы (Resources)
Список таблиц (`db://tables`), схема конкретной таблицы (`db://tables/{table_name}`) и полная схема БД (`db://schema`)
Промпты (Prompts)
Шаблоны для генерации запросов и аналитических построителей на основе естественного языка.
Инспектор MCP
Веб-интерфейс для тестирования инструментов, ресурсов и промптов перед интеграцией с AI.
Установка
Создайте виртуальное окружение:
uv venv, активируйте:source .venv/bin/activate(на Windows:.venv\Scripts\activate). Установите зависимости:uv pip install -r requirements.txt.Запустите сервер с инспектором:
npx @modelcontextprotocol/inspector uv --directory . run postgres -e DSN=postgresql://username:password@hostname:port/database -e SCHEMA=public.
Для конфигурации в AI: используйте JSON с командой uv и env (DSN, SCHEMA). Опционально: запустите ./example-db/create-db.sh для тестового БД в Docker.