Чеклист настройки MCP

Сценарий: `postgres_readonly` ## Цель Безопасное подключение PostgreSQL к Cursor для выполнения аналитических SQL-запросов через MCP с правами только на чтение. ## Предварительные условия - [ ] Node.js 18+ (проверьте `node -v`) - [ ] PostgreSQL: создан пользователь `mcp_readonly` с правами `GRANT SELECT ON ALL TABLES IN SCHEMA public TO mcp_readonly;` - [ ] Узнайте путь к `npx`: выполните в терминале `which npx` (обычно `/Users/username/.nvm/versions/node/vXX.X.X/bin/npx`). ## Конфиг MCP **Scope:** global **Файл:** `~/.cursor/mcp.json` ```json { "mcpServers": { "postgres-analytics": { "command": "/полный/путь/к/npx", "args": [ "-y", "@modelcontextprotocol/server-postgres@0.6.2", "postgresql://mcp_readonly:***@localhost:5432/shop" ], "env": { "DATABASE_URL": "postgresql://mcp_readonly:ВАШ_ПАРОЛЬ@localhost:5432/shop" } } } } ``` ## Переменные окружения | Переменная | Назначение | Где задать | |------------|------------|------------| | `DATABASE_URL` | Строка подключения | Внутри `mcp.json` (в блоке `env`) | ## Security checklist - [ ] **Read-only:** Убедитесь, что пользователь БД не имеет прав `INSERT`, `UPDATE`, `DELETE`, `DROP`. - [ ] **Изоляция:** Не добавляйте `.cursor/mcp.json` в Git (добавьте в `.gitignore`). - [ ] **Минимизация:** Не давайте доступ к системным таблицам, если это возможно. ## Проверка (5 шагов) 1. **Перезапустите Cursor** (полностью через Cmd+Q). 2. Перейдите в **Settings → Features → MCP**. Убедитесь, что `postgres-analytics` горит зеленым. 3. Откройте **Output → MCP Logs** и выберите `postgres-analytics` в выпадающем списке — ошибок быть не должно. 4. В чате Cursor (Composer или Chat) спросите: «Какие инструменты (tools) доступны через MCP?» 5. Тестовый запрос: «Выполни `SELECT * FROM users LIMIT 5;` через postgres-analytics». ## Troubleshooting: spawn ENOENT Если видите `spawn npx ENOENT` или `spawn /.../npx ENOENT`: 1. **Absolute Path:** Cursor не видит ваш `PATH` из `.zshrc`. Используйте **полный путь** к `npx`, полученный через `which npx`. 2. **Проверка команды:** Скопируйте путь из `command` и аргументы из `args`, вставьте в терминал: `/полный/путь/к/npx -y @modelcontextprotocol/server-postgres@0.6.2 postgresql://...`. Если в терминале работает, а в Cursor нет — проблема в окружении Cursor. 3. **Env PATH:** Если ошибка сохраняется, добавьте в `env` блока `mcp.json`: `"PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/полный/путь/к/папке/с/node/bin"` ## После настройки - Регулярно проверяйте `MCP Logs` на предмет подозрительных попыток записи (если случайно выдали права). - Не используйте `latest` в версиях пакетов — всегда фиксируйте версию (как в примере выше).