@liangshanli/mcp-server-project-standards 5.0.0 → 5.1.0

package/README.md

@@ -4,6 +4,10 @@ A MCP (Model Context Protocol) server for project standards management, designed
 
 ## 📋 Version Updates
 
+### v5.1.0 (2025-12-22)
+- **New Tool**: Added `download_file` tool to download files from URL to project path.
+- **Version Sync**: Updated server and package versions to 5.1.0.
+
 ### v5.0.0 (2025-12-19) - Major Release
 - **Project Path Support**: Added `PROJECT_PATH` environment variable for resolving relative paths.
 - **Cursor Detection**: Automatic identification of Cursor IDE for enhanced features.
@@ -115,6 +119,7 @@ A MCP (Model Context Protocol) server for project standards management, designed
 - ✅ **Configuration Management** - JSON-based configuration storage and management
 - ✅ **Auto-Restart** - Intelligent process management and fault recovery
 - ✅ **Health Checks** - Real-time service status and performance monitoring
+- ✅ **File Downloader** - Download files from URLs directly to the project directory
 
 ## 🎯 Application Scenarios
 
@@ -605,6 +610,29 @@ Generates AI project guidance files (`.cursorrules` for Cursor, `PROJECT_RULES.m
 }
 ```
 
+### 9. File Download Tool (download_file)
+Download a file from a URL and save it to a specified path within the project.
+
+**Parameters:**
+- `url` (required): The URL of the file to download.
+- `savePath` (required): The path where the file should be saved (relative to project path or absolute).
+
+**Example:**
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 12,
+  "method": "tools/call",
+  "params": {
+    "name": "download_file",
+    "arguments": {
+      "url": "https://example.com/logo.png",
+      "savePath": "assets/logo.png"
+    }
+  }
+}
+```
+
 ## 🔗 Related Tools for Collaborative Use
 
 To provide a more complete development experience, we recommend using the following MCP tools in collaboration:

package/README.zh-CN.md

@@ -4,6 +4,10 @@
 
 ## 📋 版本更新说明
 
+### v5.1.0 (2025-12-22)
+- **新增工具**：新增 `download_file` 工具，支持从 URL 下载文件到项目目录。
+- **版本同步**：服务器和包版本更新至 5.1.0。
+
 ### v5.0.0 (2025-12-19) - 重大更新
 - **项目路径支持**：新增 `PROJECT_PATH` 环境变量，支持相对于项目根目录解析路径。
 - **Cursor 自动识别**：初始化时自动识别 Cursor 编辑器，开启环境特有的增强模式。
@@ -99,6 +103,7 @@
 - ✅ **配置管理** - 基于 JSON 文件的配置存储和管理
 - ✅ **自动重启** - 智能的进程管理和故障恢复
 - ✅ **健康检查** - 实时监控服务状态和性能
+- ✅ **文件下载** - 支持从 URL 直接下载文件到项目目录
 
 ## 🎯 应用场景
 
@@ -593,6 +598,29 @@ API 调试工具支持完整的登录认证流程，让您轻松管理 API 访
 }
 ```
 
+### 9. 文件下载工具 (download_file)
+从指定的 URL 下载文件并保存到项目路径中的指定位置。
+
+**参数：**
+- `url` (必需): 要下载的文件的 URL。
+- `savePath` (必需): 文件保存路径（相对于项目路径或绝对路径）。
+
+**使用示例：**
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 12,
+  "method": "tools/call",
+  "params": {
+    "name": "download_file",
+    "arguments": {
+      "url": "https://example.com/logo.png",
+      "savePath": "assets/logo.png"
+    }
+  }
+}
+```
+
 ## 🔗 相关工具协同使用
 
 为了提供更完整的开发体验，推荐与以下 MCP 工具协同使用：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangshanli/mcp-server-project-standards",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "MCP Project Standards server with project info, structure, API standards, development standards, API debugging, login authentication and configuration management tools",
   "main": "bin/cli.js",
   "bin": {

package/src/server-final.js

@@ -14,6 +14,7 @@ const api_help = require('./utils/api_help');
 const api_execute = require('./utils/api_execute');
 const list_directory = require('./utils/list_directory');
 const generate_cursorrules = require('./utils/generate_cursorrules');
+const download_file = require('./utils/download_file');
 
 // Get config directory based on CONFIG_DIR and TOOL_PREFIX
 const getConfigDir = () => {
@@ -88,7 +89,7 @@ global.isCursor = false;
 class ProjectStandardsMCPServer {
   constructor() {
     this.name = 'project-standards-mcp-server';
-    this.version = '1.2.2';
+    this.version = '5.1.0';
     this.initialized = false;
     this.config = getConfig();
     this.needsProjectFolder = this.config === null;
@@ -231,6 +232,12 @@ class ProjectStandardsMCPServer {
     return result;
   }
 
+  // Download file tool
+  async download_file(params) {
+    const result = await download_file(params);
+    return result;
+  }
+
   // Handle JSON-RPC requests
   async handleRequest(request) {
     try {
@@ -740,6 +747,26 @@ class ProjectStandardsMCPServer {
           }
         });
 
+        // Download File Tool
+        tools.push({
+          name: 'download_file',
+          description: 'Download a file from a URL and save it to a specified path. Supported schemes: http, https.',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              url: {
+                type: 'string',
+                description: 'The URL of the file to download (required)'
+              },
+              savePath: {
+                type: 'string',
+                description: 'The path where the file should be saved (relative to project path or absolute, required)'
+              }
+            },
+            required: ['url', 'savePath']
+          }
+        });
+
           // API Config Tool
           tools.push({
             name: 'api_config',

package/src/utils/download_file.js

@@ -0,0 +1,76 @@
+const fs = require('fs-extra');
+const path = require('path');
+const https = require('https');
+
+// Create an agent for HTTPS requests that skips certificate verification
+const httpsAgent = new https.Agent({
+  rejectUnauthorized: false
+});
+
+/**
+ * Download file tool
+ * 
+ * @param {Object} params - Parameters
+ * @param {string} params.url - URL of the file to download
+ * @param {string} params.savePath - Path to save the file (relative to project path or absolute)
+ * @returns {Object} Download result
+ */
+async function download_file(params) {
+  const { url, savePath } = params || {};
+  
+  if (!url) {
+    throw new Error('URL is required');
+  }
+  
+  if (!savePath) {
+    throw new Error('Save path is required');
+  }
+
+  // Resolve save path
+  const projectPath = process.env.PROJECT_PATH || '.';
+  let finalSavePath = savePath;
+  if (!path.isAbsolute(savePath)) {
+    finalSavePath = path.resolve(projectPath, savePath);
+  }
+
+  try {
+    // Ensure directory exists
+    await fs.ensureDir(path.dirname(finalSavePath));
+
+    // Execute download
+    const fetchOptions = {};
+    if (url.startsWith('https')) {
+      fetchOptions.agent = httpsAgent;
+    }
+
+    const response = await fetch(url, fetchOptions);
+    
+    if (!response.ok) {
+      throw new Error(`Failed to download: \${response.status} \${response.statusText}`);
+    }
+
+    const buffer = await response.arrayBuffer();
+    await fs.writeFile(finalSavePath, Buffer.from(buffer));
+
+    return {
+      success: true,
+      message: `Successfully downloaded file to \${finalSavePath}`,
+      url: url,
+      savePath: finalSavePath,
+      size: buffer.byteLength,
+      timestamp: new Date().toISOString()
+    };
+  } catch (err) {
+    return {
+      success: false,
+      message: `Failed to download file: \${err.message}`,
+      url: url,
+      savePath: finalSavePath,
+      error: err.message,
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+
+module.exports = download_file;
+