MCP server pgconsole
Коммит 30 окт. 2026 г.Позволяет ИИ-агентам выполнять запросы и вносить изменения в PostgreSQL через управляемую конечную точку MCP с разграничением прав доступа для каждого агента и ведением журналов аудита.
Также известен как pgplex/pgconsole
- Звёзды
- 162
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 30 окт. 2026 г.
- Лицензия
- Apache-2.0
Что такое pgconsole MCP?
pgconsole — это MCP server. Позволяет ИИ-агентам выполнять запросы и вносить изменения в PostgreSQL через управляемую конечную точку MCP с разграничением прав доступа для каждого агента и ведением журналов аудита.
Сводка сгенерирована из README проекта
О pgconsole MCP server
pgconsole позволяет инженерным командам управлять доступом ИИ-агентов к PostgreSQL через управляемую конечную точку. Это дает возможность предоставлять доступ к соединениям с базой данных внешним клиентам, таким как Claude, Cursor или CI-ботам, через Model Context Protocol без передачи прямых учетных данных базы данных. Пользователи могут настроить систему с помощью одного TOML-файла и запустить ее через npm, npx или Docker.
Разработчики используют этот инструмент для реализации гранулярного контроля доступа, где агенты наследуют специфические права (например, read, write или ddl) через слой IAM. Сервер поддерживает два типа агентов: чистые сервисные аккаунты и делегированных агентов, действующих от имени пользователей. В состав входит интегрированный SQL-редактор для людей и ИИ-ассистент, работающий с провайдерами OpenAI, Anthropic или Google для выполнения таких задач, как text-to-SQL и оптимизация запросов.
Безопасность обеспечивается политикой default-deny и комплексным логированием аудита. Каждый запрос и вход в систему записываются в структурированном JSON в stdout, что позволяет командам отслеживать действия как людей, так и автоматизированных агентов. Система гарантирует, что такие инструменты, как list_objects или query, становятся доступны только после того, как агент установит авторизованное соединение.
Что вы можете с ним делать
- 1Безопасное предоставление доступа агентам к базе данныхПредоставьте ИИ-агенту определенные права на выполнение запросов к базе данных, не раскрывая реальный пароль от базы данных.
- 2Аудит всех изменений в базе данных, инициированных ИИОтслеживайте каждый SQL-запрос, выполненный ИИ-агентом, для обеспечения соответствия требованиям и прозрачности.
- 3Преобразование естественного языка в SQLИспользуйте встроенного ИИ-ассистента, чтобы преобразовать описание на обычном английском языке в рабочий запрос PostgreSQL.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийpgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHub[!NOTE] pgplex: The Postgres Toolchain for Humans and Agents - pgconsole · pgschema · pgtui · pgparser
Brought to you by Bytebase, open-source database governance platform.

pgconsole is a web-based PostgreSQL editor. Single binary, single config file, no database required. Connect your team to PostgreSQL with access control and audit logging built in.
Installation
Visit https://docs.pgconsole.com/getting-started/quickstart
Prerequisites
- Node.js 20+
npm
npm install -g @pgplex/pgconsole
pgconsole --config pgconsole.toml
npx
npx @pgplex/pgconsole --config pgconsole.toml
Docker
docker run -p 9876:9876 -v /path/to/pgconsole.toml:/etc/pgconsole.toml pgplex/pgconsole
Run without --config to start in demo mode with a bundled sample database.
Features
SQL Editor
A full-featured SQL workspace for writing, running, editing, and inspecting PostgreSQL, with parser-powered intelligence in the editor.
- Autocomplete — context-aware suggestions for tables, columns, joins, and CTEs
- Formatting — pretty-print or collapse SQL to one line
- Error detection — red underlines with hover tooltips
- Code folding — collapse
SELECT,WITH, and other blocks - Function signature help — parameter hints as you type
- Result grid & inline editing — virtual-scrolling query results with staged edits, generated SQL previews, and optional AI risk assessment before execution
- Schema browser — inspect tables, views, materialized views, functions, and procedures with metadata, indexes, constraints, triggers, and grants
AI Assistant
Generate, explain, fix, and rewrite SQL with an AI assistant that understands your schema context. Supports OpenAI, Anthropic, and Google providers.
- Text-to-SQL — describe a query in natural language, get SQL back
- Explain SQL — get plain-language explanations of any query
- Fix SQL — AI-powered error correction from inline linting
- Rewrite SQL — optimize queries for performance or readability
- Risk assessment — analyze staged changes for potential risks before execution
MCP Server
Expose your Postgres connections to external AI agents (Claude, Cursor, IDEs, CI bots) over the Model Context Protocol — without handing out raw database credentials. Agents connect to a remote MCP endpoint and inherit the same IAM, permission, and audit controls as human users.
- Remote & token-authenticated — a Streamable HTTP endpoint at
/mcp; each agent authenticates withAuthorization: Bearer <token> - Two agent kinds — a pure service account (authorized by
agent:<id>IAM rules) or a delegated agent that acts on behalf of a user, optionally capped to fewer permissions or connections - Permission-shaped tools — every agent can
list_connections; catalog tools (list_objects,describe_table) appear once it has an accessible connection, and execution tools unlock per grant:explain_query(explain),query(read),write_data(write),run_ddl(ddl) - Same governance as the UI — every statement runs through per-statement SQL permission detection, default-deny IAM, and the audit log
# A standalone agent, authorized via [[iam]] just like a user
[[agents]]
id = "ci-bot"
name = "CI Pipeline"
token = "generate-a-long-random-secret" # openssl rand -hex 32
[[iam]]
connection = "staging"
permissions = ["read", "ddl"]
members = ["agent:ci-bot"]
Database Access Control
Fine-grained IAM controls who can read, write, or administer each connection. Permissions are enforced at the application layer — no database roles needed.
- Default deny — users have no access unless a rule explicitly grants it
- Connection-scoped — permissions are granted per connection, not globally
- Disjoint permissions —
read,write,ddl,admin,explain,execute,exportare independent
Audit Log
Every query and login is recorded as structured JSON to stdout. Filter and forward to your log infrastructure.
{
"type": "audit",
"ts": "2024-01-15T10:32:15.456Z",
"action": "sql.execute",
"actor": "alice@example.com",
"connection": "prod-db",
"sql": "SELECT * FROM users WHERE active = true",
"duration_ms": 45,
"row_count": 150
}
Single-File Configuration
Everything lives in pgconsole.toml — connections, users, groups, access rules, AI providers. No database required.
[[connections]]
id = "production"
name = "Production"
host = "db.example.com"
port = 5432
database = "myapp"
username = "readonly"
password = "..."
[[iam]]
connection = "production"
permissions = ["read", "explain", "export"]
members = ["*"]
[[iam]]
connection = "production"
permissions = ["*"]
members = ["group:dba"]
[[ai.providers]]
id = "claude"
vendor = "anthropic"
model = "claude-sonnet-4-20250514"
api_key = "sk-ant-..."
Getting Help
Development
[!NOTE] For external contributors: If you want to request a feature, please create a GitHub issue to discuss first instead of creating a PR directly.
git clone https://github.com/pgplex/pgconsole.git
cd pgconsole
pnpm install
pnpm dev # Start dev server (frontend + backend)
pnpm build # Production build
pnpm test # Run all tests
Sponsor
Bytebase - open source, web-based database DevSecOps platform.
Вопросы о pgconsole MCP
Как ИИ-агент проходит аутентификацию на MCP server pgconsole?
Агенты подключаются к streamable HTTP endpoint по адресу /mcp и проходят аутентификацию с помощью bearer token, определенного для агента в конфигурационном файле.
Какие инструменты доступны агенту на MCP server pgconsole?
Каждый агент может просматривать список соединений; инструменты каталогизации и выполнения появляются в зависимости от прав, предоставленных конкретному агенту.
Нужны ли агентам учетные данные базы данных для использования pgconsole?
Нет. Вместо учетных данных базы данных агенты используют MCP endpoint и наследуют те же механизмы IAM, управления правами и аудита, что и пользователи-люди.
Аудируются ли запросы агентов в pgconsole?
Да, каждый запрос проходит через проверку SQL-прав, политику default-deny IAM и записывается в журнал аудита.
Какие типы агентов можно настроить в pgconsole?
Вы можете настроить чисто сервисную учетную запись, авторизованную правилами IAM, или делегированного агента, который действует от имени пользователя с опционально ограниченными правами.