@hypnosis/docker-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Danila Susak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# Docker MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@hypnosis/docker-mcp-server.svg)](https://www.npmjs.com/package/@hypnosis/docker-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Universal Docker MCP server for AI assistants (Cursor, Claude Desktop). Manage Docker containers, execute commands, query databases, and handle environment configurations — all through natural language.
+
+## ✨ Features
+
+- ✅ **16 MCP Commands** — Container management, database operations, environment handling
+- ✅ **Database Support** — PostgreSQL, Redis, SQLite with extensible adapter pattern
+- ✅ **Auto-Discovery** — Automatically finds and parses `docker-compose.yml` files
+- ✅ **Security** — Automatic secrets masking in environment variables
+- ✅ **Follow Logs** — Real-time log streaming with `follow` mode
+- ✅ **Type-Safe** — Written in TypeScript with full type definitions
+- ✅ **Universal** — Works with any Docker project
+
+## 📦 Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @hypnosis/docker-mcp-server
+```
+
+### NPX (No Installation)
+
+```bash
+npx @hypnosis/docker-mcp-server
+```
+
+### Local Installation
+
+```bash
+npm install @hypnosis/docker-mcp-server
+```
+
+## 🚀 Quick Start
+
+### Configuration for Cursor
+
+Add to `~/.cursor/mcp.json` (or `~/.config/cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "npx",
+      "args": ["-y", "@hypnosis/docker-mcp-server"],
+      "env": {
+        "DOCKER_MCP_AUTO_DISCOVER": "true",
+        "DOCKER_MCP_MASK_SECRETS": "true"
+      }
+    }
+  }
+}
+```
+
+### Configuration for Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "npx",
+      "args": ["-y", "@hypnosis/docker-mcp-server"]
+    }
+  }
+}
+```
+
+### First Steps
+
+1. **Restart your AI assistant** (Cursor or Claude Desktop)
+2. **Navigate to your Docker project** directory (with `docker-compose.yml`)
+3. **Ask your AI assistant:**
+   - "Show me the status of all containers"
+   - "Restart the web service"
+   - "Show me the last 50 lines of logs from the database"
+
+## 📚 Available Commands
+
+### Container Management (7 commands)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `docker_container_list` | List all containers in project | `docker_container_list()` |
+| `docker_container_start` | Start a container | `docker_container_start("web")` |
+| `docker_container_stop` | Stop a container | `docker_container_stop("web")` |
+| `docker_container_restart` | Restart a container | `docker_container_restart("web")` |
+| `docker_container_logs` | View container logs | `docker_container_logs("web", {follow: true, lines: 100})` |
+| `docker_compose_up` | Start entire stack | `docker_compose_up({build: true})` |
+| `docker_compose_down` | Stop entire stack | `docker_compose_down({volumes: false})` |
+
+### Database Operations (4 commands)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `docker_db_query` | Execute SQL query | `docker_db_query("postgres", "SELECT * FROM users LIMIT 5;")` |
+| `docker_db_backup` | Create database backup | `docker_db_backup("postgres", "./backup.sql")` |
+| `docker_db_restore` | Restore from backup | `docker_db_restore("postgres", "./backup.sql")` |
+| `docker_db_status` | Show database status | `docker_db_status("postgres")` |
+
+### Environment & Config (3 commands)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `docker_env_list` | List environment variables | `docker_env_list()` |
+| `docker_compose_config` | Show parsed compose config | `docker_compose_config()` |
+| `docker_healthcheck` | Check health of all services | `docker_healthcheck()` |
+
+### Universal Executor (1 command)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `docker_exec` | Execute any command in container | `docker_exec("web", "npm test")` |
+
+## 💡 Usage Examples
+
+### Example 1: Web Development (Next.js + Redis)
+
+```typescript
+// Start the entire stack
+docker_compose_up({build: true, detach: true})
+
+// Check if services are healthy
+docker_healthcheck()
+
+// View logs in real-time
+docker_container_logs("web", {follow: true, lines: 50})
+
+// Check Redis cache
+docker_db_query("redis", "KEYS *")
+
+// Run tests
+docker_exec("web", "npm test")
+```
+
+### Example 2: Backend Development (Django + PostgreSQL)
+
+```typescript
+// Restart backend after code changes
+docker_container_restart("web")
+
+// Run database migrations
+docker_exec("web", "python manage.py migrate")
+
+// Query database
+docker_db_query("postgres", "SELECT COUNT(*) FROM auth_user;")
+
+// Create backup before deployment
+docker_db_backup("postgres", "./backups/pre-deploy.sql")
+
+// View application logs
+docker_container_logs("web", {lines: 100, timestamps: true})
+```
+
+## 🏗️ How It Works
+
+### Project Discovery
+
+The server automatically discovers your project structure:
+
+1. **Finds `docker-compose.yml`** in current directory or parent directories
+2. **Parses project configuration** (services, networks, volumes)
+3. **Detects database types** (PostgreSQL, Redis, SQLite)
+4. **Loads environment files** (`.env`, `.env.local`)
+5. **Masks secrets** automatically (PASSWORD, TOKEN, KEY, etc.)
+
+### Database Adapters
+
+Extensible adapter pattern for different databases:
+
+- **PostgreSQL** — `psql`, `pg_dump`, `pg_restore`
+- **Redis** — `redis-cli`, `SAVE`, `BGSAVE`
+- **SQLite** — `.dump`, `.restore`
+- More databases can be added via adapters
+
+## 🔒 Security
+
+### Automatic Secrets Masking
+
+Environment variables containing sensitive data are automatically masked:
+
+```typescript
+// Original .env
+DATABASE_PASSWORD=super_secret_123
+API_TOKEN=abc123xyz
+
+// Output from docker_env_list()
+DATABASE_PASSWORD=***MASKED***
+API_TOKEN=***MASKED***
+```
+
+Keywords that trigger masking: `PASSWORD`, `TOKEN`, `KEY`, `SECRET`, `API_KEY`
+
+## 📖 Documentation
+
+- **[Quick Start Guide](docs/QUICK_START.md)** — Detailed setup instructions
+- **[API Reference](docs/API_REFERENCE.md)** — Complete command documentation
+- **[Examples](docs/EXAMPLES.md)** — Real-world usage scenarios
+- **[Troubleshooting](docs/TROUBLESHOOTING.md)** — Common issues and solutions
+- **[FAQ](docs/FAQ.md)** — Frequently asked questions
+
+For developer documentation, see [docs/DEV/README.md](docs/DEV/README.md)
+
+## 🤝 Contributing
+
+We welcome contributions! This is an open-source project built for the community.
+
+### How to Contribute
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+See [docs/DEV/README.md](docs/DEV/README.md) for development setup and guidelines.
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+Copyright (c) 2025 Danila Susak
+
+## 🙏 Acknowledgments
+
+- [Model Context Protocol](https://modelcontextprotocol.io/) by Anthropic
+- [Docker](https://www.docker.com/) for containerization
+- Community feedback and contributions
+
+## 📬 Support
+
+- **Issues:** [GitHub Issues](https://github.com/hypnosis/docker-mcp-server/issues)
+- **Discussions:** [GitHub Discussions](https://github.com/hypnosis/docker-mcp-server/discussions)
+
+---
+
+**Made with ❤️ for the AI-powered development community**

package/dist/adapters/adapter-registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Adapter Registry
+ * Регистрация и получение Database Adapters по типу БД
+ */
+import type { DatabaseAdapter } from './database-adapter.js';
+export declare class AdapterRegistry {
+    private adapters;
+    /**
+     * Регистрировать адаптер
+     */
+    register(type: string, adapter: DatabaseAdapter): void;
+    /**
+     * Получить адаптер по типу
+     */
+    get(serviceType: string): DatabaseAdapter;
+    /**
+     * Проверить наличие адаптера
+     */
+    has(serviceType: string): boolean;
+    /**
+     * Получить список всех зарегистрированных типов
+     */
+    getRegisteredTypes(): string[];
+}
+/**
+ * Singleton registry
+ */
+export declare const adapterRegistry: AdapterRegistry;
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/adapters/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../../src/adapters/adapter-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IAEtD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAMtD;;OAEG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IAgBzC;;OAEG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;CAG/B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/adapters/adapter-registry.js

@@ -0,0 +1,47 @@
+/**
+ * Adapter Registry
+ * Регистрация и получение Database Adapters по типу БД
+ */
+import { logger } from '../utils/logger.js';
+export class AdapterRegistry {
+    adapters = new Map();
+    /**
+     * Регистрировать адаптер
+     */
+    register(type, adapter) {
+        const normalizedType = type.toLowerCase();
+        this.adapters.set(normalizedType, adapter);
+        logger.debug(`Registered adapter for: ${type}`);
+    }
+    /**
+     * Получить адаптер по типу
+     */
+    get(serviceType) {
+        const type = serviceType.toLowerCase();
+        const adapter = this.adapters.get(type);
+        if (!adapter) {
+            const available = Array.from(this.adapters.keys()).join(', ');
+            throw new Error(`No adapter found for database type: ${serviceType}\n` +
+                `Available adapters: ${available || 'none'}`);
+        }
+        logger.debug(`Using adapter for: ${serviceType}`);
+        return adapter;
+    }
+    /**
+     * Проверить наличие адаптера
+     */
+    has(serviceType) {
+        return this.adapters.has(serviceType.toLowerCase());
+    }
+    /**
+     * Получить список всех зарегистрированных типов
+     */
+    getRegisteredTypes() {
+        return Array.from(this.adapters.keys());
+    }
+}
+/**
+ * Singleton registry
+ */
+export const adapterRegistry = new AdapterRegistry();
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapters/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../../src/adapters/adapter-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,WAAmB;QACrB,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,uCAAuC,WAAW,IAAI;gBACtD,uBAAuB,SAAS,IAAI,MAAM,EAAE,CAC7C,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,WAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/adapters/database-adapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Database Adapter Interface
+ * Интерфейс для работы с разными типами БД
+ */
+import type { ServiceConfig } from '../discovery/types.js';
+import type { QueryOptions, BackupOptions, RestoreOptions, DBStatus, ConnectionInfo } from './types.js';
+/**
+ * Интерфейс для Database Adapters
+ * Все адаптеры должны реализовать этот интерфейс
+ */
+export interface DatabaseAdapter {
+    /**
+     * Выполнить query или команду
+     */
+    query(service: string, query: string, options?: QueryOptions): Promise<string>;
+    /**
+     * Создать backup
+     */
+    backup(service: string, options: BackupOptions): Promise<string>;
+    /**
+     * Восстановить из backup
+     */
+    restore(service: string, backupPath: string, options?: RestoreOptions): Promise<void>;
+    /**
+     * Получить статус БД
+     */
+    status(service: string): Promise<DBStatus>;
+    /**
+     * Получить connection info из environment
+     */
+    getConnectionInfo(service: ServiceConfig, env: Record<string, string>): ConnectionInfo;
+}
+//# sourceMappingURL=database-adapter.d.ts.map

package/dist/adapters/database-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/database-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE;;OAEG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C;;OAEG;IACH,iBAAiB,CACf,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,cAAc,CAAC;CACnB"}

package/dist/adapters/database-adapter.js

@@ -0,0 +1,6 @@
+/**
+ * Database Adapter Interface
+ * Интерфейс для работы с разными типами БД
+ */
+export {};
+//# sourceMappingURL=database-adapter.js.map

package/dist/adapters/database-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-adapter.js","sourceRoot":"","sources":["../../src/adapters/database-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/adapters/postgresql.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PostgreSQL Adapter
+ * Реализация DatabaseAdapter для PostgreSQL
+ */
+import type { DatabaseAdapter } from './database-adapter.js';
+import type { QueryOptions, BackupOptions, RestoreOptions, DBStatus, ConnectionInfo } from './types.js';
+import type { ServiceConfig } from '../discovery/types.js';
+export declare class PostgreSQLAdapter implements DatabaseAdapter {
+    private containerManager;
+    private projectDiscovery;
+    private envManager;
+    constructor();
+    /**
+     * Выполнить SQL query
+     */
+    query(service: string, query: string, options?: QueryOptions): Promise<string>;
+    /**
+     * Создать backup
+     */
+    backup(service: string, options: BackupOptions): Promise<string>;
+    /**
+     * Восстановить из backup
+     */
+    restore(service: string, backupPath: string, options?: RestoreOptions): Promise<void>;
+    /**
+     * Получить статус БД
+     */
+    status(service: string): Promise<DBStatus>;
+    /**
+     * Получить connection info из environment
+     */
+    getConnectionInfo(service: ServiceConfig, env: Record<string, string>): ConnectionInfo;
+    /**
+     * Парсит версию PostgreSQL из output
+     */
+    private parseVersion;
+    /**
+     * Парсит одно значение из SQL output (первая строка, первый столбец)
+     */
+    private parseSingleValue;
+}
+//# sourceMappingURL=postgresql.d.ts.map

package/dist/adapters/postgresql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql.d.ts","sourceRoot":"","sources":["../../src/adapters/postgresql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAa;;IAQ/B;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA0CpF;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDtE;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IA8ChB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6ChD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc;IAUtF;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAWzB"}

package/dist/adapters/postgresql.js

@@ -0,0 +1,202 @@
+/**
+ * PostgreSQL Adapter
+ * Реализация DatabaseAdapter для PostgreSQL
+ */
+import { ContainerManager } from '../managers/container-manager.js';
+import { ProjectDiscovery } from '../discovery/project-discovery.js';
+import { EnvManager } from '../managers/env-manager.js';
+import { sqlValidator } from '../security/sql-validator.js';
+import { logger } from '../utils/logger.js';
+export class PostgreSQLAdapter {
+    containerManager;
+    projectDiscovery;
+    envManager;
+    constructor() {
+        this.containerManager = new ContainerManager();
+        this.projectDiscovery = new ProjectDiscovery();
+        this.envManager = new EnvManager();
+    }
+    /**
+     * Выполнить SQL query
+     */
+    async query(service, query, options) {
+        // Валидация SQL (если включена)
+        sqlValidator.validate(query);
+        const project = await this.projectDiscovery.findProject();
+        const serviceConfig = project.services[service];
+        if (!serviceConfig) {
+            throw new Error(`Service '${service}' not found in project`);
+        }
+        const env = this.envManager.loadEnv(project.projectDir, service, serviceConfig);
+        const conn = this.getConnectionInfo(serviceConfig, env);
+        const db = options?.database || conn.database;
+        const user = options?.user || conn.user;
+        // Строим команду psql
+        const format = options?.format || 'table';
+        let cmd = ['psql', '-U', user, '-d', db];
+        // Формат вывода
+        if (format === 'json') {
+            cmd.push('--json');
+        }
+        else if (format === 'csv') {
+            cmd.push('--csv');
+        }
+        // SQL query
+        cmd.push('-c', query);
+        // Пароль через PGPASSWORD env var
+        const envVars = conn.password ? [`PGPASSWORD=${conn.password}`] : [];
+        logger.debug(`Executing PostgreSQL query in ${service}: ${query}`);
+        const output = await this.containerManager.exec(service, project.name, cmd, {
+            env: envVars,
+        });
+        return output;
+    }
+    /**
+     * Создать backup
+     */
+    async backup(service, options) {
+        const project = await this.projectDiscovery.findProject();
+        const serviceConfig = project.services[service];
+        if (!serviceConfig) {
+            throw new Error(`Service '${service}' not found in project`);
+        }
+        const env = this.envManager.loadEnv(project.projectDir, service, serviceConfig);
+        const conn = this.getConnectionInfo(serviceConfig, env);
+        const format = options.format || 'custom';
+        const output = options.output || `/backups/postgres-backup-${Date.now()}.dump`;
+        // Строим команду pg_dump
+        let cmd = ['pg_dump', '-U', conn.user, '-d', conn.database];
+        // Формат backup
+        if (format === 'custom') {
+            cmd.push('-Fc'); // Custom format (compressed)
+        }
+        else if (format === 'tar') {
+            cmd.push('-Ft'); // Tar format
+        }
+        else if (format === 'directory') {
+            cmd.push('-Fd'); // Directory format
+        }
+        // 'sql' format - по умолчанию (plain SQL)
+        // Backup конкретных таблиц
+        if (options.tables && options.tables.length > 0) {
+            for (const table of options.tables) {
+                cmd.push('-t', table);
+            }
+        }
+        // Output file
+        cmd.push('-f', output);
+        // Пароль через PGPASSWORD
+        const envVars = conn.password ? [`PGPASSWORD=${conn.password}`] : [];
+        logger.info(`Creating PostgreSQL backup: ${output}`);
+        await this.containerManager.exec(service, project.name, cmd, {
+            env: envVars,
+        });
+        return output;
+    }
+    /**
+     * Восстановить из backup
+     */
+    async restore(service, backupPath, options) {
+        const project = await this.projectDiscovery.findProject();
+        const serviceConfig = project.services[service];
+        if (!serviceConfig) {
+            throw new Error(`Service '${service}' not found in project`);
+        }
+        const env = this.envManager.loadEnv(project.projectDir, service, serviceConfig);
+        const conn = this.getConnectionInfo(serviceConfig, env);
+        const db = options?.database || conn.database;
+        // Определяем формат backup по расширению
+        const isCustomFormat = backupPath.endsWith('.dump') || backupPath.endsWith('.backup');
+        let cmd;
+        if (isCustomFormat) {
+            // Custom format → pg_restore
+            cmd = ['pg_restore', '-U', conn.user, '-d', db];
+            if (options?.clean) {
+                cmd.push('--clean');
+            }
+            if (options?.dataOnly) {
+                cmd.push('--data-only');
+            }
+            if (options?.schemaOnly) {
+                cmd.push('--schema-only');
+            }
+            cmd.push(backupPath);
+        }
+        else {
+            // SQL format → psql
+            cmd = ['psql', '-U', conn.user, '-d', db, '-f', backupPath];
+        }
+        // Пароль через PGPASSWORD
+        const envVars = conn.password ? [`PGPASSWORD=${conn.password}`] : [];
+        logger.info(`Restoring PostgreSQL from backup: ${backupPath}`);
+        await this.containerManager.exec(service, project.name, cmd, {
+            env: envVars,
+        });
+    }
+    /**
+     * Получить статус БД
+     */
+    async status(service) {
+        const project = await this.projectDiscovery.findProject();
+        const serviceConfig = project.services[service];
+        if (!serviceConfig) {
+            throw new Error(`Service '${service}' not found in project`);
+        }
+        const env = this.envManager.loadEnv(project.projectDir, service, serviceConfig);
+        const conn = this.getConnectionInfo(serviceConfig, env);
+        // Получаем версию
+        const versionOutput = await this.query(service, 'SELECT version();');
+        const version = this.parseVersion(versionOutput);
+        // Получаем размер БД
+        const sizeOutput = await this.query(service, "SELECT pg_size_pretty(pg_database_size(current_database())) as size;");
+        const size = this.parseSingleValue(sizeOutput);
+        // Получаем количество подключений
+        const connectionsOutput = await this.query(service, "SELECT count(*) as connections FROM pg_stat_activity WHERE datname = current_database();");
+        const connections = parseInt(this.parseSingleValue(connectionsOutput) || '0');
+        // Получаем uptime
+        const uptimeOutput = await this.query(service, "SELECT date_trunc('second', current_timestamp - pg_postmaster_start_time()) as uptime;");
+        const uptime = this.parseSingleValue(uptimeOutput);
+        return {
+            type: 'postgresql',
+            version,
+            status: 'healthy',
+            size,
+            connections,
+            uptime,
+        };
+    }
+    /**
+     * Получить connection info из environment
+     */
+    getConnectionInfo(service, env) {
+        return {
+            host: 'localhost',
+            port: 5432,
+            user: env.POSTGRES_USER || 'postgres',
+            password: env.POSTGRES_PASSWORD,
+            database: env.POSTGRES_DB || 'postgres',
+        };
+    }
+    /**
+     * Парсит версию PostgreSQL из output
+     */
+    parseVersion(versionOutput) {
+        const match = versionOutput.match(/PostgreSQL\s+(\d+\.\d+)/i);
+        return match ? match[1] : 'unknown';
+    }
+    /**
+     * Парсит одно значение из SQL output (первая строка, первый столбец)
+     */
+    parseSingleValue(output) {
+        // Простой парсинг: берем первую строку после заголовка
+        const lines = output.split('\n').filter((line) => line.trim().length > 0);
+        if (lines.length < 2) {
+            return '';
+        }
+        // Пропускаем заголовок, берем первую строку данных
+        const dataLine = lines[1];
+        // Убираем лишние пробелы
+        return dataLine.trim();
+    }
+}
+//# sourceMappingURL=postgresql.js.map

package/dist/adapters/postgresql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql.js","sourceRoot":"","sources":["../../src/adapters/postgresql.ts"],"names":[],"mappings":"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"}