PostgreSQL

Сервер Model Context Protocol, который обеспечивает доступ только для чтения к базам данных PostgreSQL. Этот сервер позволяет LLM проверять схемы баз данных и выполнять запросы только для чтения.

Компоненты

Инструменты

• запрос

  • Выполнять SQL-запросы только для чтения к подключенной базе данных

  • Ввод: sql (строка): SQL-запрос для выполнения.

  • Все запросы выполняются в рамках транзакции ТОЛЬКО ДЛЯ ЧТЕНИЯ

Ресурсы

Сервер предоставляет информацию о схеме для каждой таблицы в базе данных:

• Схемы таблиц ( postgres://<host>/<table>/schema )

  • Информация о схеме JSON для каждой таблицы

  • Включает имена столбцов и типы данных

  • Автоматически обнаруживается из метаданных базы данных

Related MCP server: PostgreSQL Multi-Schema MCP Server

Конфигурация

Использование с Claude Desktop

Чтобы использовать этот сервер с приложением Claude Desktop, добавьте следующую конфигурацию в раздел «mcpServers» вашего claude_desktop_config.json :

Докер

• при запуске docker на macos используйте host.docker.internal, если сервер работает в хостовой сети (например, localhost)

• Имя пользователя/пароль можно добавить в URL-адрес postgresql с помощью postgresql://user:password@host:port/db-name

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

НПХ

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

Замените /mydb на имя вашей базы данных.

Использование с VS Code

Для быстрой установки используйте одну из кнопок установки в один клик ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

Докер

Примечание : при использовании Docker и подключении к серверу PostgreSQL на хост-компьютере используйте host.docker.internal вместо localhost в URL-адресе подключения.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "pg_url",
        "description": "PostgreSQL URL (e.g. postgresql://user:pass@host.docker.internal:5432/mydb)"
      }
    ],
    "servers": {
      "postgres": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "mcp/postgres",
          "${input:pg_url}"
        ]
      }
    }
  }
}

НПХ

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "pg_url",
        "description": "PostgreSQL URL (e.g. postgresql://user:pass@localhost:5432/mydb)"
      }
    ],
    "servers": {
      "postgres": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-postgres",
          "${input:pg_url}"
        ]
      }
    }
  }
}

Здание

Докер:

docker build -t mcp/postgres -f src/postgres/Dockerfile . 

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.