@liangshanli/mcp-server-project-standards 1.1.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangshanli/mcp-server-project-standards",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "MCP Project Standards server with project info, structure, API standards, development standards and custom tools",
   "main": "bin/cli.js",
   "bin": {

package/src/server-final.js

@@ -54,7 +54,7 @@ console.error('==============================================');
 class ProjectStandardsMCPServer {
   constructor() {
     this.name = 'project-standards-mcp-server';
-    this.version = '1.0.0';
+    this.version = '1.2.1';
     this.initialized = false;
     this.config = getConfig();
     this.needsProjectFolder = this.config === null;
@@ -499,7 +499,7 @@ class ProjectStandardsMCPServer {
             );
           
           // 构建 API 调试工具描述
-          let apiDebugDescription = 'API debugging tool for testing and executing API requests';
+          let apiDebugDescription = 'API debugging tool for testing and executing API requests. Use URL to identify APIs instead of index numbers.';
           
           // 检查是否设置了登录接口环境变量
           const loginUrl = process.env.API_DEBUG_LOGIN_URL;
@@ -524,6 +524,7 @@ class ProjectStandardsMCPServer {
             }
             
             apiDebugDescription += '\n\n💡 Usage Instructions:';
+            apiDebugDescription += '\n- Use URL to identify APIs for execute and delete operations (not index numbers)';
             apiDebugDescription += '\n- Login API automatically uses environment variable configuration';
             apiDebugDescription += '\n- Non-login APIs must use allowed methods only';
             apiDebugDescription += '\n- Common request headers are automatically updated after successful login';
@@ -538,7 +539,7 @@ class ProjectStandardsMCPServer {
             action: {
               type: 'string',
               enum: ['get', 'set', 'delete', 'execute', 'updateBaseUrl', 'updateHeaders', 'deleteHeader', 'search'],
-              description: 'Action to perform: "get" to retrieve config, "set" to update config, "delete" to delete API, "execute" to execute API, "updateBaseUrl" to update base URL, "updateHeaders" to update headers, "deleteHeader" to delete specific header, "search" to search APIs by URL or description'
+              description: 'Action to perform: "get" to retrieve config, "set" to update config, "delete" to delete API by URL, "execute" to execute API by URL, "updateBaseUrl" to update base URL, "updateHeaders" to update headers, "deleteHeader" to delete specific header, "search" to search APIs by URL or description'
             },
                 config: {
                   type: 'object',
@@ -592,9 +593,9 @@ class ProjectStandardsMCPServer {
                     }
                   }
                 },
-            index: {
-              type: 'number',
-              description: 'Index of API to delete or execute (required for "delete" and "execute" actions)'
+            url: {
+              type: 'string',
+              description: 'URL of API to delete or execute (required for "delete" and "execute" actions)'
             },
             baseUrl: {
               type: 'string',
@@ -630,16 +631,16 @@ class ProjectStandardsMCPServer {
                 {
                   properties: {
                     action: { const: 'delete' },
-                    index: { type: 'number' }
+                    url: { type: 'string' }
                   },
-                  required: ['index']
+                  required: ['url']
                 },
                 {
                   properties: {
                     action: { const: 'execute' },
-                    index: { type: 'number' }
+                    url: { type: 'string' }
                   },
-                  required: ['index']
+                  required: ['url']
                 },
                 {
                   properties: {

package/src/utils/api_debug.js

@@ -119,7 +119,7 @@ const detectContentType = (body) => {
  * @param {string} params.config.baseUrl - API 基础 URL
  * @param {Object} params.config.headers - 公共请求头
  * @param {Array} params.config.list - API 接口列表
- * @param {string} params.index - 要执行的接口索引（执行时必需）
+ * @param {string} params.url - 要执行的接口URL（执行时必需）
  * @param {string} params.baseUrl - 新的基础 URL（updateBaseUrl 时必需）
  * @param {Object} params.headers - 新的公共请求头（updateHeaders 时必需）
  * @param {string} params.headerName - 要删除的请求头名称（deleteHeader 时必需）
@@ -129,7 +129,7 @@ const detectContentType = (body) => {
  * @returns {Object} API 调试结果
  */
 async function api_debug(params, config, saveConfig) {
-  const { action, config: apiConfig, index } = params || {};
+  const { action, config: apiConfig, url } = params || {};
   
   if (!action) {
     throw new Error('Missing action parameter. Must be "get", "set", "delete", "execute", "updateBaseUrl", "updateHeaders", "deleteHeader", or "search"');
@@ -199,8 +199,8 @@ async function api_debug(params, config, saveConfig) {
       throw new Error(`Failed to update API debug config: ${err.message}`);
     }
   } else if (action === 'delete') {
-    if (!index && index !== 0) {
-      throw new Error('Missing index parameter for delete action');
+    if (!url) {
+      throw new Error('Missing url parameter for delete action');
     }
     
     try {
@@ -211,31 +211,36 @@ async function api_debug(params, config, saveConfig) {
         apiDebugConfig.list = [];
       }
       
-      // 删除指定索引的接口
-      if (index >= 0 && index < apiDebugConfig.list.length) {
-        const deletedItem = apiDebugConfig.list.splice(index, 1)[0];
-        
-        // 保存配置
-        const saved = saveApiConfig(apiDebugConfig);
-        if (!saved) {
-          throw new Error('Failed to save API configuration');
-        }
-        
+      // 查找并删除指定URL的接口
+      const originalLength = apiDebugConfig.list.length;
+      apiDebugConfig.list = apiDebugConfig.list.filter(item => item.url !== url);
+      
+      if (apiDebugConfig.list.length === originalLength) {
         return {
-          success: true,
-          message: `Successfully deleted API at index ${index}`,
-          deletedItem: deletedItem,
+          success: false,
+          message: `API with URL "${url}" not found`,
           timestamp: new Date().toISOString()
         };
-      } else {
-        throw new Error(`Invalid index: ${index}. Must be between 0 and ${apiDebugConfig.list.length - 1}`);
       }
+      
+      // 保存配置
+      const saved = saveApiConfig(apiDebugConfig);
+      if (!saved) {
+        throw new Error('Failed to save API configuration');
+      }
+      
+      return {
+        success: true,
+        message: `Successfully deleted API with URL: ${url}`,
+        deletedUrl: url,
+        timestamp: new Date().toISOString()
+      };
     } catch (err) {
       throw new Error(`Failed to delete API: ${err.message}`);
     }
   } else if (action === 'execute') {
-    if (!index && index !== 0) {
-      throw new Error('Missing index parameter for execute action');
+    if (!url) {
+      throw new Error('Missing url parameter for execute action');
     }
     
     try {
@@ -243,14 +248,23 @@ async function api_debug(params, config, saveConfig) {
       const apiDebugConfig = loadApiConfig();
       
       if (!apiDebugConfig.list || !Array.isArray(apiDebugConfig.list)) {
-        throw new Error('API list not found or invalid');
+        apiDebugConfig.list = [];
       }
       
-      if (index < 0 || index >= apiDebugConfig.list.length) {
-        throw new Error(`Invalid index: ${index}. Must be between 0 and ${apiDebugConfig.list.length - 1}`);
-      }
+      // 查找指定URL的接口，如果不存在则创建一个新的
+      let apiItem = apiDebugConfig.list.find(item => item.url === url);
+      let itemIndex = apiDebugConfig.list.findIndex(item => item.url === url);
       
-      const apiItem = apiDebugConfig.list[index];
+      if (!apiItem) {
+        // 如果接口不存在，创建一个新的接口配置
+        apiItem = {
+          url: url,
+          method: 'GET',
+          description: `API: ${url}`
+        };
+        apiDebugConfig.list.push(apiItem);
+        itemIndex = apiDebugConfig.list.length - 1;
+      }
       const baseUrl = apiDebugConfig.baseUrl || '';
       const commonHeaders = apiDebugConfig.headers || {};
       
@@ -291,8 +305,13 @@ async function api_debug(params, config, saveConfig) {
         }
       }
       
-      // 构建完整 URL
-      const fullUrl = baseUrl + apiItem.url;
+      // 构建完整 URL - 如果用户提供的是完整URL，直接使用；否则拼接baseUrl
+      let fullUrl;
+      if (apiItem.url.startsWith('http://') || apiItem.url.startsWith('https://')) {
+        fullUrl = apiItem.url;
+      } else {
+        fullUrl = baseUrl + apiItem.url;
+      }
       
       // 合并请求头
       const headers = {
@@ -417,23 +436,23 @@ async function api_debug(params, config, saveConfig) {
           success = isHttpSuccess;
           
           // 记录响应信息
-          apiDebugConfig.list[index].data = responseData;
-          apiDebugConfig.list[index].status = response.status;
-          apiDebugConfig.list[index].statusText = response.statusText;
-          apiDebugConfig.list[index].responseHeaders = Object.fromEntries(response.headers.entries());
-          apiDebugConfig.list[index].lastExecuted = new Date().toISOString();
-          apiDebugConfig.list[index].success = isHttpSuccess;
-          apiDebugConfig.list[index].error = isHttpSuccess ? null : `HTTP ${response.status}: ${response.statusText}`;
+          apiDebugConfig.list[itemIndex].data = responseData;
+          apiDebugConfig.list[itemIndex].status = response.status;
+          apiDebugConfig.list[itemIndex].statusText = response.statusText;
+          apiDebugConfig.list[itemIndex].responseHeaders = Object.fromEntries(response.headers.entries());
+          apiDebugConfig.list[itemIndex].lastExecuted = new Date().toISOString();
+          apiDebugConfig.list[itemIndex].success = isHttpSuccess;
+          apiDebugConfig.list[itemIndex].error = isHttpSuccess ? null : `HTTP ${response.status}: ${response.statusText}`;
         } else {
           // 记录失败信息
           success = false;
-          apiDebugConfig.list[index].data = null;
-          apiDebugConfig.list[index].status = null;
-          apiDebugConfig.list[index].statusText = null;
-          apiDebugConfig.list[index].responseHeaders = null;
-          apiDebugConfig.list[index].lastExecuted = new Date().toISOString();
-          apiDebugConfig.list[index].success = false;
-          apiDebugConfig.list[index].error = error;
+          apiDebugConfig.list[itemIndex].data = null;
+          apiDebugConfig.list[itemIndex].status = null;
+          apiDebugConfig.list[itemIndex].statusText = null;
+          apiDebugConfig.list[itemIndex].responseHeaders = null;
+          apiDebugConfig.list[itemIndex].lastExecuted = new Date().toISOString();
+          apiDebugConfig.list[itemIndex].success = false;
+          apiDebugConfig.list[itemIndex].error = error;
         }
         
         // 去重处理：相同的 URL 只保留一份（保留最新的执行结果）
@@ -451,9 +470,9 @@ async function api_debug(params, config, saveConfig) {
       } catch (requestError) {
         // 只有请求相关的错误才保存到 api.json
         try {
-          apiDebugConfig.list[index].lastExecuted = new Date().toISOString();
-          apiDebugConfig.list[index].success = false;
-          apiDebugConfig.list[index].error = requestError.message;
+          apiDebugConfig.list[itemIndex].lastExecuted = new Date().toISOString();
+          apiDebugConfig.list[itemIndex].success = false;
+          apiDebugConfig.list[itemIndex].error = requestError.message;
           saveApiConfig(apiDebugConfig);
         } catch (saveErr) {
           console.error('Failed to save request error information:', saveErr.message);
@@ -496,10 +515,11 @@ async function api_debug(params, config, saveConfig) {
       // 如果是在保存配置时出错，也要尝试记录错误信息
       try {
         const apiDebugConfig = loadApiConfig();
-        if (apiDebugConfig.list && apiDebugConfig.list[index]) {
-          apiDebugConfig.list[index].lastExecuted = new Date().toISOString();
-          apiDebugConfig.list[index].success = false;
-          apiDebugConfig.list[index].error = err.message;
+        const itemIndex = apiDebugConfig.list.findIndex(item => item.url === url);
+        if (apiDebugConfig.list && itemIndex >= 0) {
+          apiDebugConfig.list[itemIndex].lastExecuted = new Date().toISOString();
+          apiDebugConfig.list[itemIndex].success = false;
+          apiDebugConfig.list[itemIndex].error = err.message;
           saveApiConfig(apiDebugConfig);
         }
       } catch (saveErr) {