@conte777/db-view-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 conte777
+
+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,341 @@
+# db-view-mcp
+
+MCP server that gives AI assistants direct access to PostgreSQL and ClickHouse databases. Supports stdio and HTTP transports, allowing both local IDE integration and remote network access.
+
+## Features
+
+- **Multi-database** — connect to any number of PostgreSQL and ClickHouse instances simultaneously
+- **Dual transport** — stdio for IDE integration (Cursor, Claude Code), HTTP for remote/multi-client access
+- **Read & write tools** — SELECT queries with row limits, INSERT/UPDATE/DELETE, DDL, transactions
+- **Schema introspection** — list tables, describe columns, export full DDL
+- **Query analysis** — EXPLAIN ANALYZE support, slow query tracking
+- **SQL safety** — read-only tools validate SQL to block accidental writes
+- **Flexible tool modes** — single tool with `database` parameter, or separate tool per database
+- **Lazy connections** — databases connect on first use by default
+- **Bearer auth** — optional token-based authentication for HTTP transport
+- **Session management** — stateful (per-session MCP server) or stateless HTTP mode
+
+## Quick start
+
+### Install
+
+```bash
+npm install @conte777/db-view-mcp
+```
+
+Or clone and build from source:
+
+```bash
+git clone <repo-url>
+cd db-view-mcp
+npm install
+npm run build
+```
+
+### Configure
+
+Copy the example config and edit it:
+
+```bash
+cp config.example.json config.json
+```
+
+Minimal config (stdio, default):
+
+```json
+{
+  "databases": [
+    {
+      "id": "main_pg",
+      "type": "postgresql",
+      "host": "localhost",
+      "port": 5432,
+      "database": "myapp",
+      "user": "admin",
+      "password": "secret123"
+    }
+  ]
+}
+```
+
+HTTP transport config:
+
+```json
+{
+  "transport": {
+    "type": "http",
+    "port": 3000,
+    "host": "127.0.0.1",
+    "stateless": false,
+    "auth": {
+      "type": "bearer",
+      "token": "your-secret-token"
+    }
+  },
+  "databases": [
+    {
+      "id": "main_pg",
+      "type": "postgresql",
+      "host": "localhost",
+      "port": 5432,
+      "database": "myapp",
+      "user": "admin",
+      "password": "secret123"
+    }
+  ]
+}
+```
+
+### Run
+
+```bash
+# Stdio (default)
+npm start -- --config config.json
+
+# HTTP via config (set transport.type to "http" in config.json)
+npm start -- --config config.json
+
+# HTTP via CLI flag (overrides config)
+npm start -- --config config.json --transport http
+
+# Development (no build needed)
+npm run dev -- --config config.json
+```
+
+### Add to your MCP client
+
+**Claude Desktop** (`claude_desktop_config.json`) — stdio:
+
+```json
+{
+  "mcpServers": {
+    "database": {
+      "command": "npx",
+      "args": ["-y", "@conte777/db-view-mcp", "--config", "/path/to/config.json"]
+    }
+  }
+}
+```
+
+**Claude Code** (`.mcp.json`) — stdio:
+
+```json
+{
+  "mcpServers": {
+    "database": {
+      "command": "npx",
+      "args": ["-y", "@conte777/db-view-mcp", "--config", "/path/to/config.json"]
+    }
+  }
+}
+```
+
+**Any MCP client** — HTTP:
+
+```bash
+# Start the server
+node dist/index.js --config config.json --transport http
+# Server listens on http://127.0.0.1:3000/mcp
+```
+
+## Transport modes
+
+### Stdio (default)
+
+Communication via stdin/stdout. Best for local IDE integrations where the MCP client spawns the server process.
+
+### HTTP
+
+Uses the MCP Streamable HTTP transport (`POST/GET/DELETE /mcp`). Best for:
+- Remote access over the network
+- Multiple clients connecting simultaneously
+- Web application integrations
+
+**Stateful mode** (default): each MCP session gets its own `McpServer` instance with a unique session ID. All sessions share database connection pools. Supports transactions across requests within the same session.
+
+**Stateless mode** (`"stateless": true`): no session management. Each request is independent. Suitable for simple query scenarios without transactions.
+
+#### HTTP endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/mcp` | Send JSON-RPC requests (initialize, tools/call, etc.) |
+| `GET` | `/mcp` | SSE stream for server-to-client notifications |
+| `DELETE` | `/mcp` | Close a session |
+| `GET` | `/health` | Health check — status, active sessions, database list |
+
+#### Authentication
+
+Optional bearer token authentication:
+
+```json
+{
+  "transport": {
+    "type": "http",
+    "auth": {
+      "type": "bearer",
+      "token": "your-secret-token"
+    }
+  }
+}
+```
+
+Requests to `/mcp` must include `Authorization: Bearer your-secret-token`. Requests without a valid token receive `401 Unauthorized`. The `/health` endpoint is not protected.
+
+#### Example: initialize a session
+
+```bash
+curl -X POST http://localhost:3000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer your-secret-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "initialize",
+    "params": {
+      "protocolVersion": "2025-03-26",
+      "capabilities": {},
+      "clientInfo": { "name": "test", "version": "1.0" }
+    }
+  }'
+```
+
+The response includes a `Mcp-Session-Id` header. Use it in subsequent requests:
+
+```bash
+curl -X POST http://localhost:3000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer your-secret-token" \
+  -H "Mcp-Session-Id: <session-id-from-init>" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 2,
+    "method": "tools/list",
+    "params": {}
+  }'
+```
+
+## Tools
+
+### Read-only
+
+| Tool | Description |
+|------|-------------|
+| `query` | Execute a SELECT query with automatic row limit |
+| `list_databases` | List all configured database connections |
+| `list_tables` | List tables and views in a schema |
+| `describe_table` | Get column names, types, nullability, and primary keys |
+| `schema` | Export full DDL for a database |
+| `explain_query` | Run EXPLAIN ANALYZE (PostgreSQL) or EXPLAIN (ClickHouse) |
+| `performance` | Track and retrieve slow queries, set thresholds |
+
+### Write
+
+| Tool | Description |
+|------|-------------|
+| `execute` | Run INSERT, UPDATE, DELETE, or DDL statements |
+| `transaction` | Begin, execute within, commit, or rollback transactions (PostgreSQL only) |
+
+## Configuration
+
+### Transport
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `transport.type` | `"stdio"` \| `"http"` | `"stdio"` | Transport mode |
+| `transport.port` | number | `3000` | HTTP listen port |
+| `transport.host` | string | `"127.0.0.1"` | HTTP bind address |
+| `transport.stateless` | boolean | `false` | Disable session management |
+| `transport.auth.type` | `"bearer"` | — | Authentication type |
+| `transport.auth.token` | string | — | Bearer token value |
+
+The `transport` field is optional. When omitted, stdio is used. The `--transport` CLI flag overrides the config value.
+
+### Defaults
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxRows` | number | `100` | Maximum rows returned by `query` |
+| `lazyConnection` | boolean | `true` | Connect on first use instead of at startup |
+| `toolsPerDatabase` | boolean | `false` | Register separate tools per database (e.g. `query_main_pg`) |
+| `queryTimeout` | number | `30000` | Query timeout in milliseconds |
+
+### PostgreSQL database
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `id` | yes | — | Unique identifier |
+| `type` | yes | — | Must be `"postgresql"` |
+| `host` | yes | — | Hostname |
+| `port` | no | `5432` | Port |
+| `database` | yes | — | Database name |
+| `user` | yes | — | Username |
+| `password` | no | `""` | Password |
+| `ssl` | no | — | Enable SSL |
+| `description` | no | — | Human-readable label |
+| `lazyConnection` | no | inherits | Override default |
+| `maxRows` | no | inherits | Override default |
+| `queryTimeout` | no | inherits | Override default |
+
+### ClickHouse database
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `id` | yes | — | Unique identifier |
+| `type` | yes | — | Must be `"clickhouse"` |
+| `url` | yes | — | HTTP URL (e.g. `http://localhost:8123`) |
+| `database` | yes | — | Database name |
+| `user` | no | `"default"` | Username |
+| `password` | no | `""` | Password |
+| `description` | no | — | Human-readable label |
+| `lazyConnection` | no | inherits | Override default |
+| `maxRows` | no | inherits | Override default |
+| `queryTimeout` | no | inherits | Override default |
+
+### Per-database tool mode
+
+Set `"toolsPerDatabase": true` in defaults to register a separate tool for each database. Instead of a single `query` tool with a `database` parameter, you get `query_main_pg`, `query_analytics`, etc. Useful when connecting many databases to avoid parameter confusion.
+
+## Architecture
+
+```
+src/
+├── index.ts              Entry point: CLI args → config → transport routing
+├── server.ts             Creates McpServer + ConnectorManager, registers tools
+├── config/
+│   ├── types.ts          Zod schemas for config validation (transport, databases)
+│   └── loader.ts         Reads config file, parses CLI args (--config, --transport)
+├── connectors/
+│   ├── interface.ts      Connector interface and shared types
+│   ├── manager.ts        Connector lifecycle (lazy/eager, create, disconnect)
+│   ├── postgresql.ts     PostgreSQL implementation (pg)
+│   └── clickhouse.ts     ClickHouse implementation (@clickhouse/client)
+├── tools/
+│   ├── registry.ts       Registers tools in parameter or per-database mode
+│   ├── readonly/         query, list-tables, describe-table, schema, explain, performance
+│   └── write/            execute, transaction
+├── transport/
+│   └── http.ts           HTTP transport: Express app, session management, auth
+└── utils/
+    ├── response.ts       Standardized MCP response formatting
+    └── sql-validator.ts   Blocks write keywords in read-only queries
+```
+
+## ClickHouse limitations
+
+- Transactions are not supported (throws an error)
+- Query parameters via `params` are ignored — use ClickHouse's native `{name:Type}` syntax in SQL
+
+## Development
+
+```bash
+npm run dev -- --config config.json   # Run with tsx, auto-reload
+npm run build                         # Compile TypeScript to dist/
+npm start -- --config config.json     # Run compiled output
+```
+
+## License
+
+MIT

package/config.example.json

@@ -0,0 +1,41 @@
+{
+  "transport": {
+    "type": "http",
+    "port": 3000,
+    "host": "127.0.0.1",
+    "stateless": false,
+    "auth": {
+      "type": "bearer",
+      "token": "your-secret-token"
+    }
+  },
+  "defaults": {
+    "maxRows": 100,
+    "lazyConnection": true,
+    "toolsPerDatabase": false,
+    "queryTimeout": 30000
+  },
+  "databases": [
+    {
+      "id": "main_pg",
+      "type": "postgresql",
+      "host": "localhost",
+      "port": 5432,
+      "database": "myapp",
+      "user": "admin",
+      "password": "secret123",
+      "description": "Main PostgreSQL",
+      "lazyConnection": true,
+      "maxRows": 200
+    },
+    {
+      "id": "analytics",
+      "type": "clickhouse",
+      "url": "http://localhost:8123",
+      "database": "analytics",
+      "user": "default",
+      "password": "",
+      "description": "ClickHouse analytics"
+    }
+  ]
+}

package/dist/config/loader.d.ts

@@ -0,0 +1,6 @@
+import { type AppConfig } from "./types.js";
+export declare function loadConfig(configPath: string): AppConfig;
+export declare function parseCliArgs(args: string[]): {
+    configPath: string;
+    transport?: "stdio" | "http";
+};

package/dist/config/loader.js

@@ -0,0 +1,28 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { AppConfigSchema } from "./types.js";
+export function loadConfig(configPath) {
+    const absolutePath = resolve(configPath);
+    const raw = readFileSync(absolutePath, "utf-8");
+    const json = JSON.parse(raw);
+    return AppConfigSchema.parse(json);
+}
+export function parseCliArgs(args) {
+    const configIndex = args.indexOf("--config");
+    if (configIndex === -1 || configIndex + 1 >= args.length) {
+        throw new Error("Usage: db-view-mcp --config <path-to-config.json> [--transport stdio|http]");
+    }
+    const result = {
+        configPath: args[configIndex + 1],
+    };
+    const transportIndex = args.indexOf("--transport");
+    if (transportIndex !== -1 && transportIndex + 1 < args.length) {
+        const value = args[transportIndex + 1];
+        if (value !== "stdio" && value !== "http") {
+            throw new Error(`Invalid transport: "${value}". Must be "stdio" or "http".`);
+        }
+        result.transport = value;
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAE7D,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,MAAM,GAAyD;QACnE,UAAU,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;KAClC,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,+BAA+B,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,149 @@
+import { z } from "zod";
+declare const PostgresConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"postgresql">;
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodString;
+    user: z.ZodString;
+    password: z.ZodDefault<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    lazyConnection: z.ZodOptional<z.ZodBoolean>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    queryTimeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ClickHouseConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"clickhouse">;
+    url: z.ZodString;
+    database: z.ZodString;
+    user: z.ZodDefault<z.ZodString>;
+    password: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    lazyConnection: z.ZodOptional<z.ZodBoolean>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    queryTimeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const DatabaseConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"postgresql">;
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodString;
+    user: z.ZodString;
+    password: z.ZodDefault<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    lazyConnection: z.ZodOptional<z.ZodBoolean>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    queryTimeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"clickhouse">;
+    url: z.ZodString;
+    database: z.ZodString;
+    user: z.ZodDefault<z.ZodString>;
+    password: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    lazyConnection: z.ZodOptional<z.ZodBoolean>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    queryTimeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "type">;
+declare const DefaultsSchema: z.ZodObject<{
+    maxRows: z.ZodDefault<z.ZodNumber>;
+    lazyConnection: z.ZodDefault<z.ZodBoolean>;
+    toolsPerDatabase: z.ZodDefault<z.ZodBoolean>;
+    queryTimeout: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const HttpTransportConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodString>;
+    stateless: z.ZodDefault<z.ZodBoolean>;
+    auth: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"bearer">;
+        token: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const TransportConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"stdio">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodString>;
+    stateless: z.ZodDefault<z.ZodBoolean>;
+    auth: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"bearer">;
+        token: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+export declare const AppConfigSchema: z.ZodObject<{
+    transport: z.ZodDefault<z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        port: z.ZodDefault<z.ZodNumber>;
+        host: z.ZodDefault<z.ZodString>;
+        stateless: z.ZodDefault<z.ZodBoolean>;
+        auth: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "type">>>;
+    defaults: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        maxRows: z.ZodDefault<z.ZodNumber>;
+        lazyConnection: z.ZodDefault<z.ZodBoolean>;
+        toolsPerDatabase: z.ZodDefault<z.ZodBoolean>;
+        queryTimeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        maxRows: number;
+        lazyConnection: boolean;
+        toolsPerDatabase: boolean;
+        queryTimeout: number;
+    }, {
+        maxRows: number;
+        lazyConnection: boolean;
+        toolsPerDatabase: boolean;
+        queryTimeout: number;
+    } | undefined>>;
+    databases: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"postgresql">;
+        host: z.ZodString;
+        port: z.ZodDefault<z.ZodNumber>;
+        database: z.ZodString;
+        user: z.ZodString;
+        password: z.ZodDefault<z.ZodString>;
+        ssl: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        lazyConnection: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        queryTimeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"clickhouse">;
+        url: z.ZodString;
+        database: z.ZodString;
+        user: z.ZodDefault<z.ZodString>;
+        password: z.ZodDefault<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        lazyConnection: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        queryTimeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type PostgresConfig = z.infer<typeof PostgresConfigSchema>;
+export type ClickHouseConfig = z.infer<typeof ClickHouseConfigSchema>;
+export type DatabaseConfig = z.infer<typeof DatabaseConfigSchema>;
+export type Defaults = z.infer<typeof DefaultsSchema>;
+export type AppConfig = z.infer<typeof AppConfigSchema>;
+export type HttpTransportConfig = z.infer<typeof HttpTransportConfigSchema>;
+export type TransportConfig = z.infer<typeof TransportConfigSchema>;
+export type ResolvedDatabaseConfig = DatabaseConfig & {
+    lazyConnection: boolean;
+    maxRows: number;
+    queryTimeout: number;
+};
+export declare function resolveDbConfig(db: DatabaseConfig, defaults: Defaults): ResolvedDatabaseConfig;
+export {};

package/dist/config/types.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+const PostgresConfigSchema = z.object({
+    id: z.string(),
+    type: z.literal("postgresql"),
+    host: z.string(),
+    port: z.number().default(5432),
+    database: z.string(),
+    user: z.string(),
+    password: z.string().default(""),
+    ssl: z.boolean().optional(),
+    description: z.string().optional(),
+    lazyConnection: z.boolean().optional(),
+    maxRows: z.number().optional(),
+    queryTimeout: z.number().optional(),
+});
+const ClickHouseConfigSchema = z.object({
+    id: z.string(),
+    type: z.literal("clickhouse"),
+    url: z.string(),
+    database: z.string(),
+    user: z.string().default("default"),
+    password: z.string().default(""),
+    description: z.string().optional(),
+    lazyConnection: z.boolean().optional(),
+    maxRows: z.number().optional(),
+    queryTimeout: z.number().optional(),
+});
+const DatabaseConfigSchema = z.discriminatedUnion("type", [
+    PostgresConfigSchema,
+    ClickHouseConfigSchema,
+]);
+const DefaultsSchema = z.object({
+    maxRows: z.number().default(100),
+    lazyConnection: z.boolean().default(true),
+    toolsPerDatabase: z.boolean().default(false),
+    queryTimeout: z.number().default(30000),
+});
+const HttpTransportConfigSchema = z.object({
+    type: z.literal("http"),
+    port: z.number().default(3000),
+    host: z.string().default("127.0.0.1"),
+    stateless: z.boolean().default(false),
+    auth: z.object({
+        type: z.literal("bearer"),
+        token: z.string(),
+    }).optional(),
+});
+const StdioTransportConfigSchema = z.object({
+    type: z.literal("stdio"),
+});
+const TransportConfigSchema = z.discriminatedUnion("type", [
+    StdioTransportConfigSchema,
+    HttpTransportConfigSchema,
+]);
+export const AppConfigSchema = z.object({
+    transport: TransportConfigSchema.optional().default({ type: "stdio" }),
+    defaults: DefaultsSchema.optional().transform((v) => v ?? {
+        maxRows: 100,
+        lazyConnection: true,
+        toolsPerDatabase: false,
+        queryTimeout: 30000,
+    }),
+    databases: z.array(DatabaseConfigSchema).min(1),
+});
+export function resolveDbConfig(db, defaults) {
+    return {
+        ...db,
+        lazyConnection: db.lazyConnection ?? defaults.lazyConnection,
+        maxRows: db.maxRows ?? defaults.maxRows,
+        queryTimeout: db.queryTimeout ?? defaults.queryTimeout,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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