Claude Code как настроить MCP сервер для работы с локальной базой данных

[tiriti]

Пытаюсь подружить Claude Code с локальной PostgreSQL через MCP. Читал доки, но там всё как-то размыто. Создал конфиг в ~/.claude/settings.json, прописал mcpServers, указал команду запуска — и ничего. Claude вообще не видит инструменты от сервера. Кто-нибудь успешно запускал MCP с локальной БД? Какой минимальный рабочий конфиг выглядит у вас?

[ivan21]

У меня заработало только когда я указал абсолютный путь к бинарнику сервера, а не полагался на PATH. Claude Code запускает процессы в своём окружении, и там PATH может отличаться от твоего терминала. Попробуй в поле command написать что-то типа /usr/local/bin/mcp-server-postgres вместо просто mcp-server-postgres.

[envoy69]

Ещё момент — после изменения settings.json нужно полностью перезапустить Claude Code, простой reload не подхватывает новые MCP серверы. Я на этом потерял минут сорок. И проверь логи через claude --mcp-debug, там видно что именно падает при инициализации.

[b1llyn0m]

Для PostgreSQL конкретно советую использовать официальный @modelcontextprotocol/server-postgres. Конфиг примерно такой: в mcpServers добавляешь ключ postgres, command: npx, args: ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]. Работает стабильно, Claude видит схему и может писать запросы зная реальную структуру таблиц. Главное — дать пользователю БД права только на чтение если не хочешь сюрпризов.

[Bill2001]

А вы вообще не боитесь давать AI прямой доступ к базе данных? Я понимаю что удобно, но представь что Claude Code в агентном режиме что-нибудь задропает или данные сольёт в промпт который потом в логах осядет.

[k8s_master]

Боятся надо, но голову не терять. Read-only коннекшн + отдельный пользователь БД с минимальными правами решает большинство рисков. Для разработки это реально ускоряет работу — Claude сам смотрит на реальные типы колонок и не генерирует запросы с несуществующими полями.

[nightgamer]

Добавлю про отладку: команда claude mcp list в терминале показывает все зарегистрированные серверы и их статус. Если сервер показывается но инструменты не появляются — скорее всего сервер падает при инициализации. Запусти его вручную в терминале той же командой что в конфиге и смотри stderr.

[delphin]

@Bill2001, риски реальные, но практика такая: для разработки заводишь отдельного PostgreSQL-пользователя с правами CONNECT + SELECT только на нужные схемы — CREATE USER claude_mcp WITH PASSWORD '...' и дальше GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_mcp. DROP или INSERT этот юзер физически не выполнит, даже если Claude Code попробует. Для прода само собой такой конфиг не используешь, только локальная dev-база.

[Bill2001]

@ivan21, про абсолютный путь подтверждаю и добавлю: проблема часто в том что Claude Code запускается через Spotlight или dock и не наследует .zshrc где у тебя прописаны nvm/pyenv/brew. Команда which npx в терминале показывает одно, а в среде Claude Code PATH другой. Самый надёжный способ проверить — запустить в конфиге command как /bin/sh с args [-c, 'which npx && npx -y @modelcontextprotocol/server-postgres ...'] и в логах увидишь какой npx реально нашёлся.

[KafkaAndy]

Про отладку ещё один момент которого в треде не было: если claude mcp list показывает сервер в статусе failed, смотри не только stderr при ручном запуске, но и проверь что пакет вообще установлен. npx с флагом -y пытается скачать пакет на лету, и если нет интернета или npm registry отвечает медленно — сервер падает по таймауту при инициализации. Надёжнее один раз установить глобально npm install -g @modelcontextprotocol/server-postgres и указать абсолютный путь к бинарнику в node_modules/.bin.