read-only-local-postgres-mcp-server

read-only-local-postgres-mcp-server

hovecapitalMIT
2 звёзд1 форков
MCP-сервер для выполнения запросов на чтение к PostgreSQL через Claude Desktop. Разработчики, аналитики и DevOps могут обращаться к базе данных на естественном языке и получать ответы в формате JSON. Сервер работает только в режиме чтения: все запросы проходят проверку, и выполнение разрешается только для операторов SELECT. Это делает сервер безопасным для использования на рабочих базах данных. Сервер особенно полезен для быстрого анализа данных без необходимости писать SQL-запросы вручную. Достаточно задать вопрос на русском языке, и Claude выполнит соответствующий SELECT-запрос к вашей базе.

Установка

npx -y @hovecapital/read-only-postgres-mcp-server

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

Общее

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

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Выполнение SQL-запросов SELECT через Claude Desktop и Claude Code на естественном языке.
  • Динамическое подключение к любой базе PostgreSQL во время работы сервера.
  • Встроенная валидация запросов: команды INSERT, UPDATE, DELETE блокируются.
  • Результаты запросов возвращаются в структурированном JSON.
  • Настройка подключения через переменные окружения (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD).
  • Возможность переопределить параметры подключения во время сессии (runtime override).
  • Готовая поддержка Claude Desktop — достаточно добавить конфигурацию в JSON.
  • Установка в одну строку через npx или через MCP Registry.

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

1. Установите сервер через npx:

npx -y @hovecapital/read-only-postgres-mcp-server

2. Настройте переменные окружения для подключения к вашей базе данных: DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD.

3. Отредактируйте файл конфигурации Claude Desktop. На macOS он находится по пути ~/Library/Application Support/Claude/claude_desktop_config.json, на Windows — %APPDATA%\Claude\claude_desktop_config.json. Добавьте следующий блок:

{ "mcpServers": { "postgres": { "command": "npx", "args": ["-y", "@hovecapital/read-only-postgres-mcp-server"], "env": { "DB_HOST": "localhost", "DB_PORT": "5432", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

4. Перезапустите Claude Desktop. Теперь можно задавать вопросы о базе данных.

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

  • «Покажи список всех таблиц в текущей базе данных»
  • «Выведи первые 20 записей из таблицы users»
  • «Сколько заказов было сделано в каждом месяце за последний год?»
  • «Найди продукт с наибольшим количеством продаж»

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

Язык: JavaScript

Транспорт: stdio

Лицензия: MIT

Совместимые клиенты: Claude Desktop, Claude Code

Требования: Node.js v16 или выше, PostgreSQL

Поделиться