@storage4everyone/mcp 0.1.1 → 0.2.1

package/dist/env.d.ts

@@ -0,0 +1,8 @@
+export declare const ENV_FILES: string[];
+/** Minimal dotenv parser: KEY=value, optional `export`, quotes, and trailing # comments. */
+export declare function parseEnv(text: string): Record<string, string>;
+/**
+ * Fills S4E_API_KEY and S4E_BUCKET from the project's .env files when the MCP config does
+ * not set them. Values already in `env` always win. Returns the files that supplied a value.
+ */
+export declare function loadEnvFiles(dir: string, env?: NodeJS.ProcessEnv): Promise<string[]>;

package/dist/env.js

@@ -0,0 +1,51 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+// Same order as Next.js and Vite in development: the first file that sets a value wins.
+export const ENV_FILES = ['.env.development.local', '.env.local', '.env.development', '.env'];
+// S4E_API_BASE and S4E_MCP_* are never read from files: a cloned project must not be able
+// to send your key to another server or turn on write tools.
+const FILE_KEYS = ['S4E_API_KEY', 'S4E_BUCKET'];
+/** Minimal dotenv parser: KEY=value, optional `export`, quotes, and trailing # comments. */
+export function parseEnv(text) {
+    const out = {};
+    for (const line of text.split(/\r?\n/)) {
+        const match = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        let value = match[2].trim();
+        const quote = value[0];
+        if ((quote === '"' || quote === "'") && value.lastIndexOf(quote) > 0)
+            value = value.slice(1, value.lastIndexOf(quote));
+        else
+            value = value.replace(/\s+#.*$/, '');
+        out[match[1]] = value;
+    }
+    return out;
+}
+/**
+ * Fills S4E_API_KEY and S4E_BUCKET from the project's .env files when the MCP config does
+ * not set them. Values already in `env` always win. Returns the files that supplied a value.
+ */
+export async function loadEnvFiles(dir, env = process.env) {
+    const used = [];
+    for (const file of ENV_FILES) {
+        let text;
+        try {
+            text = await readFile(path.join(dir, file), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const values = parseEnv(text);
+        let supplied = false;
+        for (const key of FILE_KEYS) {
+            if (!env[key] && values[key]) {
+                env[key] = values[key];
+                supplied = true;
+            }
+        }
+        if (supplied)
+            used.push(file);
+    }
+    return used;
+}

package/dist/index.js

@@ -3,14 +3,28 @@ import { realpath } from 'node:fs/promises';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { Storage4Everyone } from '@storage4everyone/sdk';
 import { createServer } from './server.js';
+import { loadEnvFiles } from './env.js';
 // stdout carries the MCP protocol; all diagnostics go to stderr.
+// Claude Code passes the project folder in CLAUDE_PROJECT_DIR and may start servers elsewhere;
+// other agents (VS Code, Gemini CLI) start them in the project folder.
+const project = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const rootSetting = process.env.S4E_MCP_ROOT || project;
+let root;
+try {
+    root = await realpath(rootSetting);
+}
+catch {
+    console.error(`S4E_MCP_ROOT folder not found: ${rootSetting}. Create it or set S4E_MCP_ROOT to an existing folder.`);
+    process.exit(1);
+}
+const envFiles = await loadEnvFiles(project);
 if (!process.env.S4E_API_KEY) {
-    console.error('S4E_API_KEY is not set. Create an API key in the Storage4Everyone dashboard and pass it in the MCP server env.');
+    console.error(`S4E_API_KEY is not set. Add S4E_API_KEY=s4e_live_... to .env.local in ${project}, or pass it in the MCP server env. ` +
+        'Create a key in the Storage4Everyone dashboard under API Keys.');
     process.exit(1);
 }
 // No automatic retries: rate-limit errors go back to the agent with their retry time.
 const client = new Storage4Everyone({ maxRetries: 0 });
-const root = await realpath(process.env.S4E_MCP_ROOT || process.cwd());
 const allowWrite = process.env.S4E_MCP_ALLOW_WRITE === 'true';
 await createServer({ client, root, allowWrite }).connect(new StdioServerTransport());
-console.error(`Storage4Everyone MCP server ready (folder: ${root}, write tools: ${allowWrite ? 'on' : 'off'}).`);
+console.error(`Storage4Everyone MCP server ready (folder: ${root}, settings from: ${envFiles.length ? envFiles.join(', ') : 'MCP env'}, write tools: ${allowWrite ? 'on' : 'off'}).`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storage4everyone/mcp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Model Context Protocol server that lets AI agents use Storage4Everyone buckets with your API key",
   "type": "module",
   "main": "./dist/server.js",