PlainQuery | MCP DB Agent

PlainQuery | MCP DB Agent

Jarvis-27MIT
PlainQuery — MCP-сервер для работы с PostgreSQL и SQLite. Вместо написания SQL вы задаёте вопросы на обычном языке прямо из Claude, Cursor или VS Code. Сервер сам анализирует схему базы, генерирует безопасный запрос и возвращает структурированные данные в формате JSON. Сервер решает главную проблему: вам не нужно помнить синтаксис SQL или структуру таблиц. Достаточно сформулировать задачу — PlainQuery сделает всё остальное. Встроенная проверка безопасности блокирует любые изменения данных, поэтому сервер можно смело подключать к рабочим базам.
Ai-mlSearchDatabasesPostgres
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • РазработчикJarvis-27
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    streamable-http

Описание

Возможности

  • Задавайте вопросы на естественном языке — сервер преобразует их в SQL
  • Автоматическое определение схемы базы данных: сервер находит таблицы, колонки и их типы
  • Генерация запросов через LLM (Claude или Groq) с учётом контекста схемы
  • Многоступенчатая проверка безопасности: блокируются INSERT, UPDATE, DELETE, DDL и опасные функции
  • Автоматическое добавление LIMIT, чтобы случайно не нагрузить базу
  • Самокоррекция: при ошибке выполнения сервер передаёт её LLM, исправляет запрос и повторяет попытку
  • Возврат результатов в формате JSON — готово для интеграции с другими инструментами
  • Работает как облачный сервис (без установки) или в вашем Docker-окружении
  • Поддержка PostgreSQL и SQLite в одной кодовой базе
  • Безопасное мультитенантное хранение: строки подключений шифруются, а подозрительные запросы блокируются

Как подключить

Облачная версия

  1. Зарегистрируйтесь на сайте plainquery.in и подтвердите электронную почту
  2. Подключите базу данных и создайте API-ключ
  3. Добавьте сервер в конфигурацию MCP-клиента. Пример для Claude Desktop:
{ "mcpServers": { "PlainQuery": { "url": "https://api.plainquery.in", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Самостоятельный запуск (Docker)

  1. Клонируйте репозиторий: git clone https://github.com/Jarvis-27/mcp-db-agent
  2. Соберите и запустите контейнер: docker compose up
  3. Укажите адрес локального сервера (http://localhost:8000) в настройках клиента

После настройки перезапустите MCP-клиент. В списке инструментов появится PlainQuery.

Примеры запросов

  • «Сколько заказов было отправлено в марте?»
  • «Покажи 5 клиентов, которые потратили больше всего за последний год»
  • «Рассчитай среднюю сумму заказа по месяцам»
  • «Какие товары закончились на складе?»

Технические детали

  • Язык разработки: Python
  • Транспорт: Streamable HTTP
  • Лицензия: MIT
  • Разработчик: Jarvis-27
  • Поддерживаемые базы: PostgreSQL, SQLite
  • LLM-провайдеры: Anthropic Claude, Groq
  • Совместимые клиенты: Claude Desktop, Cursor, VS Code Copilot, любой MCP-клиент с поддержкой HTTP

Поделиться