Neon MCP Server

Что умеет сервер

Это официальный MCP-сервер компании Neon, которая предоставляет Postgres как облачный сервис. Сервер работает как мост между запросами на естественном языке и API Neon. Через него агент создаёт и удаляет проекты и ветки, смотрит схему (get_database_tables, describe_table_schema), выполняет SQL (run_sql, run_sql_transaction), сравнивает схемы веток, управляет вычислительными эндпоинтами и снимками, просматривает медленные запросы и планы выполнения. Есть также инструменты для Neon Auth, Data API, хранилища, функций и поиска по документации.

Отдельная особенность сервера: безопасные миграции. Инструмент prepare_database_migration применяет изменение схемы во временной ветке, чтобы агент мог проверить результат, а complete_database_migration переносит его в основную ветку. Аналогично работают prepare_query_tuning и complete_query_tuning: оптимизацию запроса, например новый индекс, сначала пробуют на временной ветке.

Когда использовать

Сервер подходит для разработки: создать базу и таблицу, накатить миграцию, посмотреть, что хранится в проектах, найти тяжёлый запрос. README приводит примеры просьб: создать базу my-database и таблицу users, добавить столбец created_at в существующую таблицу, дать сводку по всем проектам Neon. Быстрая настройка рассчитана на Cursor, VS Code с GitHub Copilot и Claude Code, а руководства в документации Neon есть ещё для Claude Desktop, Cline, Windsurf и Zed.

Ограничения и безопасность

Авторы предупреждают в самом начале README: сервер даёт мощные возможности управления базой по просьбе на естественном языке, поэтому всегда проверяйте действия, которые запрашивает модель, и открывайте доступ только своим пользователям и приложениям. Сервер рассчитан на локальную разработку и интеграцию с IDE, и использовать его в продакшене Neon не рекомендует, потому что случайное изменение или удаление вполне возможно.

Ограничить права можно параметрами адреса: readonly=true отключает инструменты записи, projectId привязывает сервер к одному проекту, category оставляет только нужные группы инструментов, roleName выполняет весь SQL от имени заданной роли Postgres вместо владельца базы. В режиме read-only run_sql остаётся доступным, но каждый запрос идёт в транзакции READ ONLY. По умолчанию при входе через OAuth сервер работает с проектами личного аккаунта, для проектов организации нужно указать идентификатор организации или проекта. Сервер собирает аналитику использования и отчёты об ошибках: в события вызова входят имя инструмента, способ авторизации и клиент, но не аргументы и не результаты запросов, а при входе под аккаунтом передаются также идентификатор аккаунта, имя и адрес электронной почты. Для подключения нужен Node.js 18 или новее, а если у вас включён IP Allow, в список разрешённых адресов нужно добавить два статических адреса mcp.neon.tech, указанные в README.

Быстрая настройка (Cursor, VS Code, Claude Code)

Команда сама войдёт в Neon через OAuth, создаст ключ API и настроит редактор:

npx neon@latest init

Удалённый сервер с OAuth

Добавит сервер во все найденные в рабочем каталоге агенты и редакторы:

npx add-mcp "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema"

Без фильтра по категориям будут доступны все инструменты:

npx add-mcp https://mcp.neon.tech/mcp

Флаг -g добавляет сервер в глобальный список, а не в проектный. Либо добавьте запись «Neon» в файл конфигурации клиента (например, mcp.json или mcp_config.json):

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema"
    }
  }
}

После этого перезапустите клиент и в открывшемся окне браузера разрешите доступ к аккаунту Neon.

Удалённый сервер с ключом API

Если OAuth недоступен, создайте ключ API в консоли Neon и передайте его в заголовке:

npx add-mcp "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema" --header "Authorization: Bearer <$NEON_API_KEY>"

Либо в конфигурации клиента:

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema",
      "headers": {
        "Authorization": "Bearer <$NEON_API_KEY>"
      }
    }
  }
}

Режим только чтения

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?readonly=true"
    }
  }
}

Чтобы ограничить сервер ещё и одним проектом, добавьте параметр projectId:

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?readonly=true&projectId=my-project-id"
    }
  }
}

Kiro

Добавьте в ~/.kiro/settings/mcp.json (глобально) или .kiro/settings/mcp.json (для проекта):

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema"
    }
  }
}