@pilat/mcp-datalink 1.2.3 → 1.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +40 -0
  2. package/dist/config/loader.d.ts +5 -0
  3. package/dist/config/loader.d.ts.map +1 -1
  4. package/dist/config/loader.js +20 -1
  5. package/dist/config/loader.js.map +1 -1
  6. package/package.json +1 -1
package/README.md CHANGED
@@ -55,6 +55,46 @@ sqlite:///Users/me/data/app.sqlite
55
55
  sqlite://../relative/path/data.db
56
56
  ```
57
57
 
58
+ ### Environment Variable Substitution
59
+
60
+ URLs support `${VAR}` syntax to reference other environment variables:
61
+
62
+ ```json
63
+ {
64
+ "mcpServers": {
65
+ "datalink": {
66
+ "command": "npx",
67
+ "args": ["-y", "@pilat/mcp-datalink"],
68
+ "env": {
69
+ "DATALINK_MAIN_URL": "${DATABASE_URL}"
70
+ }
71
+ }
72
+ }
73
+ }
74
+ ```
75
+
76
+ This allows reusing existing environment variables (like `DATABASE_URL` from your shell or `.env` file).
77
+
78
+ **Supported syntax:**
79
+
80
+ | Syntax | Description |
81
+ |--------|-------------|
82
+ | `${VAR}` | Expands to value of `VAR`, or keeps `${VAR}` if unset |
83
+ | `${VAR:-default}` | Expands to value of `VAR`, or `default` if unset |
84
+
85
+ **Examples:**
86
+
87
+ ```bash
88
+ # Reference existing DATABASE_URL
89
+ DATALINK_MAIN_URL="${DATABASE_URL}"
90
+
91
+ # Build URL from parts
92
+ DATALINK_MAIN_URL="postgresql://${DB_USER}:${DB_PASS}@${DB_HOST}:5432/mydb"
93
+
94
+ # With default values
95
+ DATALINK_MAIN_URL="postgresql://localhost:${DB_PORT:-5432}/mydb"
96
+ ```
97
+
58
98
  ### Config File Locations
59
99
 
60
100
  | Client | Config file |
package/dist/config/loader.d.ts CHANGED
@@ -1,4 +1,9 @@
1
1
  import type { Config } from '../types.js';
2
+ /**
3
+ * Expand environment variable references in a string.
4
+ * Supports ${VAR_NAME} and ${VAR_NAME:-default} syntax.
5
+ */
6
+ export declare function expandEnvVariables(value: string): string;
2
7
  /**
3
8
  * Load configuration from environment variables.
4
9
  *
package/dist/config/loader.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkC,MAAM,aAAa,CAAC;AAuC1E;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAWnC"}
1
+ {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkC,MAAM,aAAa,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAexD;AAqCD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAWnC"}
package/dist/config/loader.js CHANGED
@@ -1,4 +1,23 @@
1
1
  import { DbMcpError, ErrorCode } from '../utils/errors.js';
2
+ /**
3
+ * Expand environment variable references in a string.
4
+ * Supports ${VAR_NAME} and ${VAR_NAME:-default} syntax.
5
+ */
6
+ export function expandEnvVariables(value) {
7
+ // Pattern matches ${VAR_NAME} or ${VAR_NAME:-default_value}
8
+ const pattern = /\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}/g;
9
+ return value.replace(pattern, (match, varName, defaultValue) => {
10
+ const envValue = process.env[varName];
11
+ if (envValue !== undefined) {
12
+ return envValue;
13
+ }
14
+ if (defaultValue !== undefined) {
15
+ return defaultValue;
16
+ }
17
+ // Return original match if variable not found and no default
18
+ return match;
19
+ });
20
+ }
2
21
  const DEFAULT_CONFIG = {
3
22
  maxRows: 100,
4
23
  maxCellLength: 500,
@@ -22,7 +41,7 @@ function getDatabasesFromEnv() {
22
41
  const readonlyKey = `DATALINK_${match[1]}_READONLY`;
23
42
  const readonlyValue = process.env[readonlyKey];
24
43
  databases[name] = {
25
- url: value,
44
+ url: expandEnvVariables(value),
26
45
  readonly: readonlyValue === 'true' || readonlyValue === '1',
27
46
  };
28
47
  }
package/dist/config/loader.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,cAAc,GAAmB;IACrC,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,KAAK,EAAE,OAAO;IAC5B,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,GAAG;IACd,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,KAAK;CACf,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,MAAM,SAAS,GAAmC,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,6BAA6B,CAAC;IAEjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACpD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAE/C,SAAS,CAAC,IAAI,CAAC,GAAG;gBAChB,GAAG,EAAE,KAAK;gBACV,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,GAAG;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,gBAAgB,EAC1B,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACjD,CAAC"}
1
+ {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,4DAA4D;IAC5D,MAAM,OAAO,GAAG,+CAA+C,CAAC;IAEhE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,YAAqB,EAAE,EAAE;QAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,6DAA6D;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,cAAc,GAAmB;IACrC,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,KAAK,EAAE,OAAO;IAC5B,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,GAAG;IACd,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,KAAK;CACf,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,MAAM,SAAS,GAAmC,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,6BAA6B,CAAC;IAEjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACpD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAE/C,SAAS,CAAC,IAAI,CAAC,GAAG;gBAChB,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC;gBAC9B,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,GAAG;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,gBAAgB,EAC1B,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACjD,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pilat/mcp-datalink",
3
- "version": "1.2.3",
3
+ "version": "1.2.5",
4
4
  "description": "MCP server for secure database access (PostgreSQL, MySQL, SQLite)",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",