mcp-cos-upload 1.1.4 → 1.1.6

package/README.md

@@ -37,7 +37,13 @@ After publishing, team members can use it immediately (see Quick Start below).
 
 #### Method 1: Project `.env` File (Recommended)
 
-1. Create a `.env` file in your project root:
+1. Install once:
+
+```bash
+npm i -g mcp-cos-upload
+```
+
+2. Create a `.env` file in your project root:
 
 ```bash
 # Copy the template
@@ -54,25 +60,26 @@ COS_KEY_PREFIX=figma-assets
 COS_CDN_DOMAIN=cdn.example.com
 ```
 
-2. Add MCP configuration (Cursor Settings → MCP):
+3. Add MCP configuration (Cursor Settings → MCP):
 
 ```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"]
+      "command": "mcp-cos-upload"
     }
   }
 }
 ```
 
-> **Why not `npx`?** npm's `npx -y` outputs package installation info to stdout, which conflicts with MCP's stdio protocol. The shell wrapper auto-installs silently and keeps stdout clean.
+> **Why this is recommended:** MCP startup stays short and predictable. The server only executes the installed binary and does not run npm during startup.
+
+> **Why not `npx`?** npm's `npx -y` outputs package installation info to stdout, which conflicts with MCP's stdio protocol.
 
 > **Note:** The `.env` file contains secrets — never commit it. Use `.env.example` as a reference template.
 
 The server only reads one file:
-1. `process.cwd()/.env`
+1. `<project-root>/.env`
 
 It does **not** read:
 1. MCP `env` configuration
@@ -80,6 +87,25 @@ It does **not** read:
 3. Parent directory `.env`
 4. `COS_ENV_PATH`
 
+Project root is inferred from the current working directory by walking upward and finding common project markers such as `.git`, `package.json`, `pnpm-workspace.yaml`, `.cursor`, or `.mcp.json`. After the root is determined, only that single `.env` file is read.
+
+#### Method 2: Auto-Install On First Run (Optional)
+
+Use this only if you explicitly want convenience over startup stability:
+
+```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"]
+    }
+  }
+}
+```
+
+This mode installs automatically only when the command is missing. It does **not** auto-update an already installed version.
+
 ### Environment Variables
 
 | Variable | Required | Description |
@@ -243,7 +269,7 @@ Compression is enabled by default. Use `compress: false` to upload original file
 
 ### `Unexpected token` / JSON parse error on startup
 
-This happens when using `npx -y mcp-cos-upload` directly — npm outputs package installation info to stdout, breaking MCP's stdio protocol. **Use the recommended shell wrapper config** in Quick Start instead.
+This happens when using `npx -y mcp-cos-upload` directly — npm outputs package installation info to stdout, breaking MCP's stdio protocol. **Use the recommended direct command config** in Quick Start instead.
 
 ### Missing COS_SECRET_ID or COS_SECRET_KEY
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-cos-upload",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "MCP server for uploading files to Tencent Cloud COS",
   "type": "module",
   "main": "src/index.js",

package/src/cos.js

@@ -1,9 +1,52 @@
 // mcp-cos-upload - COS client configuration
 import COS from "cos-nodejs-sdk-v5";
 import { readFileSync, existsSync } from "fs";
-import { join } from "path";
+import { dirname, join, resolve } from "path";
 
-const PROJECT_ENV_PATH = join(process.cwd(), ".env");
+const REPO_MARKERS = [".git", ".hg", ".svn"];
+const PROJECT_MARKERS = [
+  ".mcp.json",
+  ".cursor",
+  ".claude",
+  "package.json",
+  "pnpm-workspace.yaml",
+  "turbo.json",
+  "lerna.json",
+  "nx.json",
+  "pyproject.toml",
+  "Cargo.toml",
+  "go.mod",
+];
+
+function hasAnyMarker(dirPath, markerNames) {
+  return markerNames.some((markerName) => existsSync(join(dirPath, markerName)));
+}
+
+function findProjectRoot(startDir) {
+  let currentDir = resolve(startDir);
+  let repoRoot = null;
+  let projectRoot = null;
+
+  while (true) {
+    if (hasAnyMarker(currentDir, REPO_MARKERS)) {
+      repoRoot = currentDir;
+    }
+
+    if (hasAnyMarker(currentDir, PROJECT_MARKERS)) {
+      projectRoot = currentDir;
+    }
+
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) break;
+    currentDir = parentDir;
+  }
+
+  return repoRoot || projectRoot || resolve(startDir);
+}
+
+const CURRENT_WORKING_DIRECTORY = process.cwd();
+const PROJECT_ROOT = findProjectRoot(CURRENT_WORKING_DIRECTORY);
+const PROJECT_ENV_PATH = join(PROJECT_ROOT, ".env");
 
 function parseEnvFile(filePath) {
   const env = {};
@@ -32,8 +75,9 @@ function getMissingCredentialMessage() {
   if (!fileEnv) {
     return [
       "[mcp-cos-upload] ❌ 未找到配置文件",
-      `只会读取项目根目录 .env: ${PROJECT_ENV_PATH}`,
-      `当前工作目录: ${process.cwd()}`,
+      `项目根目录: ${PROJECT_ROOT}`,
+      `只会读取这个文件: ${PROJECT_ENV_PATH}`,
+      `当前工作目录: ${CURRENT_WORKING_DIRECTORY}`,
       "请在该文件中设置：",
       "COS_SECRET_ID=your_secret_id",
       "COS_SECRET_KEY=your_secret_key",
@@ -44,8 +88,9 @@ function getMissingCredentialMessage() {
 
   return [
     "[mcp-cos-upload] ❌ .env 缺少 COS_SECRET_ID 或 COS_SECRET_KEY",
+    `项目根目录: ${PROJECT_ROOT}`,
     `只读取此文件: ${PROJECT_ENV_PATH}`,
-    `当前工作目录: ${process.cwd()}`,
+    `当前工作目录: ${CURRENT_WORKING_DIRECTORY}`,
     "请补全以下字段：",
     "COS_SECRET_ID=your_secret_id",
     "COS_SECRET_KEY=your_secret_key",

package/src/index.js

@@ -56,7 +56,7 @@ const cosUploadInputSchema = {
 
 async function main() {
   const server = new Server(
-    { name: "mcp-cos-upload", version: "1.1.2" },
+    { name: "mcp-cos-upload", version: "1.1.5" },
     { capabilities: { tools: {} } }
   );