mcp-cos-upload 1.1.2 → 1.1.3

package/.env.example

@@ -0,0 +1,10 @@
+# Tencent Cloud COS Configuration
+# Copy this file to .env and fill in your values
+# cp .env.example .env
+
+COS_SECRET_ID=
+COS_SECRET_KEY=
+COS_DEFAULT_BUCKET=
+COS_DEFAULT_REGION=ap-guangzhou
+COS_KEY_PREFIX=figma-assets
+COS_CDN_DOMAIN=

package/README.md

@@ -71,38 +71,14 @@ COS_CDN_DOMAIN=cdn.example.com
 
 > **Note:** The `.env` file contains secrets — never commit it. Use `.env.example` as a reference template.
 
-The server searches for `.env` in the following order:
-1. `$COS_ENV_PATH` (custom path via env var)
-2. Project root (`process.cwd()/.env`, set by Cursor to workspace root)
-3. `~/.mcp-cos-upload.env`
-4. `~/.config/mcp-cos-upload/.env`
+The server only reads one file:
+1. Project root `.env` (`/path/to/mcp-cos-upload/.env`)
 
-#### Method 2: MCP `env` Configuration
-
-Alternatively, pass credentials directly in MCP config (no `.env` file needed):
-
-```json
-{
-  "mcpServers": {
-    "mcp-cos-upload": {
-      "command": "sh",
-      "args": ["-c", "command -v mcp-cos-upload >/dev/null 2>&1 || npm i -g mcp-cos-upload >/dev/null 2>&1; exec mcp-cos-upload"],
-      "env": {
-        "COS_SECRET_ID": "your_secret_id",
-        "COS_SECRET_KEY": "your_secret_key",
-        "COS_DEFAULT_BUCKET": "your_bucket_name",
-        "COS_DEFAULT_REGION": "ap-guangzhou",
-        "COS_KEY_PREFIX": "figma-assets",
-        "COS_CDN_DOMAIN": "cdn.example.com"
-      }
-    }
-  }
-}
-```
-
-#### Priority
-
-If both are configured, project `.env` file takes **higher priority** over MCP `env` configuration.
+It does **not** read:
+1. MCP `env` configuration
+2. Home directory `.env`
+3. Parent directory `.env`
+4. `COS_ENV_PATH`
 
 ### Environment Variables
 
@@ -271,7 +247,7 @@ This happens when using `npx -y mcp-cos-upload` directly — npm outputs package
 
 ### Missing COS_SECRET_ID or COS_SECRET_KEY
 
-The server cannot find your credentials. Make sure you have a `.env` file in your project root (or `~/.mcp-cos-upload.env`). Check the `.env.example` template for required variables.
+The server only reads the project root `.env`. If that file does not exist, or if it is missing `COS_SECRET_ID` / `COS_SECRET_KEY`, tool calls will return a clear error telling you to fix that single file.
 
 ### MCP not working after code changes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-cos-upload",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "MCP server for uploading files to Tencent Cloud COS",
   "type": "module",
   "main": "src/index.js",
@@ -8,7 +8,8 @@
     "mcp-cos-upload": "src/index.js"
   },
   "files": [
-    "src/**/*"
+    "src/**/*",
+    ".env.example"
   ],
   "keywords": [
     "mcp",

package/src/cos.js

@@ -2,12 +2,14 @@
 import COS from "cos-nodejs-sdk-v5";
 import { readFileSync, existsSync } from "fs";
 import { join, dirname } from "path";
-import { homedir } from "os";
 import { fileURLToPath } from "url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ENV_PATH = join(__dirname, "..", ".env");
+
+function parseEnvFile(filePath) {
+  const env = {};
 
-function loadEnvFile(filePath) {
   try {
     const content = readFileSync(filePath, "utf-8");
     for (const line of content.split("\n")) {
@@ -17,43 +19,63 @@ function loadEnvFile(filePath) {
       if (eqIdx === -1) continue;
       const key = trimmed.slice(0, eqIdx).trim();
       const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
-      if (key && !process.env[key]) process.env[key] = value;
+      if (key) env[key] = value;
     }
-    return true;
   } catch {
-    return false;
+    return null;
   }
+
+  return env;
 }
 
-const envPaths = [
-  process.env.COS_ENV_PATH,
-  join(process.cwd(), ".env"),
-  join(homedir(), ".mcp-cos-upload.env"),
-  join(homedir(), ".config", "mcp-cos-upload", ".env"),
-  join(__dirname, "..", ".env"),
-].filter(Boolean);
-
-for (const envPath of envPaths) {
-  if (existsSync(envPath)) {
-    loadEnvFile(envPath);
-    process.stderr.write(`[mcp-cos-upload] loaded env from ${envPath}\n`);
-    break;
+const fileEnv = existsSync(PROJECT_ENV_PATH) ? parseEnvFile(PROJECT_ENV_PATH) : null;
+
+function getMissingCredentialMessage() {
+  if (!fileEnv) {
+    return [
+      "[mcp-cos-upload] ❌ 未找到配置文件",
+      `只会读取项目根目录 .env: ${PROJECT_ENV_PATH}`,
+      "请在该文件中设置：",
+      "COS_SECRET_ID=your_secret_id",
+      "COS_SECRET_KEY=your_secret_key",
+      "COS_DEFAULT_BUCKET=your_bucket_name",
+      "COS_DEFAULT_REGION=ap-guangzhou",
+    ].join("\n");
   }
+
+  return [
+    "[mcp-cos-upload] ❌ .env 缺少 COS_SECRET_ID 或 COS_SECRET_KEY",
+    `只读取此文件: ${PROJECT_ENV_PATH}`,
+    "请补全以下字段：",
+    "COS_SECRET_ID=your_secret_id",
+    "COS_SECRET_KEY=your_secret_key",
+  ].join("\n");
+}
+
+function getRequiredConfigValue(key) {
+  return fileEnv?.[key] || null;
+}
+
+export function getCosClientConfigError() {
+  const secretId = getRequiredConfigValue("COS_SECRET_ID");
+  const secretKey = getRequiredConfigValue("COS_SECRET_KEY");
+
+  if (secretId && secretKey) return null;
+  return getMissingCredentialMessage();
 }
 
 export function createCosClient() {
-  const secretId = process.env.COS_SECRET_ID;
-  const secretKey = process.env.COS_SECRET_KEY;
+  const configError = getCosClientConfigError();
 
-  if (!secretId || !secretKey) {
-    console.error("[mcp-cos-upload] ❌ 缺少 COS_SECRET_ID 或 COS_SECRET_KEY");
-    process.exit(1);
-  }
+  if (configError) throw new Error(configError);
 
-  return new COS({ SecretId: secretId, SecretKey: secretKey });
+  return new COS({
+    SecretId: getRequiredConfigValue("COS_SECRET_ID"),
+    SecretKey: getRequiredConfigValue("COS_SECRET_KEY"),
+  });
 }
 
-export const DEFAULT_BUCKET = process.env.COS_DEFAULT_BUCKET || null;
-export const DEFAULT_REGION = process.env.COS_DEFAULT_REGION || null;
-export const KEY_PREFIX = process.env.COS_KEY_PREFIX || "figma-assets";
-export const CDN_DOMAIN = process.env.COS_CDN_DOMAIN || null;
+export const DEFAULT_BUCKET = getRequiredConfigValue("COS_DEFAULT_BUCKET");
+export const DEFAULT_REGION = getRequiredConfigValue("COS_DEFAULT_REGION");
+export const KEY_PREFIX = getRequiredConfigValue("COS_KEY_PREFIX") || "figma-assets";
+export const CDN_DOMAIN = getRequiredConfigValue("COS_CDN_DOMAIN");

package/src/index.js

@@ -20,8 +20,6 @@ import {
   CDN_DOMAIN,
 } from "./cos.js";
 
-const cos = createCosClient();
-
 // 工具参数校验（zod）
 const CosUploadArgsSchema = z.object({
   bucket: z.string().optional().describe("COS Bucket 名，不传则用默认 COS_DEFAULT_BUCKET"),
@@ -58,7 +56,7 @@ const cosUploadInputSchema = {
 
 async function main() {
   const server = new Server(
-    { name: "mcp-cos-upload", version: "1.0.0" },
+    { name: "mcp-cos-upload", version: "1.1.2" },
     { capabilities: { tools: {} } }
   );
 
@@ -103,6 +101,16 @@ async function main() {
       return { isError: true, content: [{ type: "text", text: "必须提供 content、url 或 filepath 其中一个参数。" }] };
     }
 
+    let cos;
+    try {
+      cos = createCosClient();
+    } catch (err) {
+      return {
+        isError: true,
+        content: [{ type: "text", text: err?.message || String(err) }],
+      };
+    }
+
     // 扩展名到 MIME 类型映射
     const extToMimeType = {
       png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg",