mcp-cos-upload 1.1.5 → 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,20 +60,21 @@ 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.
 
@@ -82,6 +89,23 @@ It does **not** read:
 
 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 |
@@ -245,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.5",
+  "version": "1.1.6",
   "description": "MCP server for uploading files to Tencent Cloud COS",
   "type": "module",
   "main": "src/index.js",

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: {} } }
   );