@liangshanli/mcp-server-project-standards 2.0.7 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangshanli/mcp-server-project-standards",
-  "version": "2.0.7",
+  "version": "2.1.1",
   "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

@@ -11,6 +11,7 @@ const api_login = require('./utils/api_login');
 const api_debug = require('./utils/api_debug');
 const api_config = require('./utils/api_config');
 const api_help = require('./utils/api_help');
+const api_execute = require('./utils/api_execute');
 
 // Get configuration from file or environment
 const getConfig = () => {
@@ -186,6 +187,12 @@ class ProjectStandardsMCPServer {
     return result;
   }
 
+  // API execute tool
+  async api_execute(params) {
+    const result = await api_execute(params, this.config, saveConfig);
+    return result;
+  }
+
 
 
 
@@ -631,21 +638,68 @@ class ProjectStandardsMCPServer {
             }
           });
 
-          // API Help Tool
-          tools.push({
-            name: 'api_help',
-            description: 'API help tool that provides detailed documentation and examples for all API debugging tools. Use this to understand how to use api_debug, api_login, and api_config tools effectively',
-            inputSchema: {
-              type: 'object',
-              properties: {
-                tool: {
-                  type: 'string',
-                  description: 'Specific tool name to get help for (optional: api_debug, api_login, api_config)',
-                  examples: ['api_debug', 'api_login', 'api_config']
-                }
+        // API Help Tool
+        tools.push({
+          name: 'api_help',
+          description: 'API help tool that provides detailed documentation and examples for all API debugging tools. Use this to understand how to use api_debug, api_login, and api_config tools effectively',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              tool: {
+                type: 'string',
+                description: 'Specific tool name to get help for (optional: api_debug, api_login, api_config)',
+                examples: ['api_debug', 'api_login', 'api_config']
               }
             }
-          });
+          }
+        });
+
+        // API Execute Tool
+        tools.push({
+          name: 'api_execute',
+          description: 'Execute API requests by index from configured API list. Examples: execute API at index 0, execute with overrides {"method":"POST","body":{"key":"value"}}',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              index: {
+                type: 'number',
+                description: 'Index of the API to execute from the configured list (required)',
+                minimum: 0
+              },
+              overrides: {
+                type: 'object',
+                description: 'Optional parameters to override the configured API settings',
+                properties: {
+                  url: {
+                    type: 'string',
+                    description: 'Override the API URL'
+                  },
+                  method: {
+                    type: 'string',
+                    enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'],
+                    description: 'Override the HTTP method'
+                  },
+                  headers: {
+                    type: 'object',
+                    description: 'Override or add request headers'
+                  },
+                  query: {
+                    type: 'object',
+                    description: 'Override query parameters'
+                  },
+                  body: {
+                    description: 'Override request body'
+                  },
+                  contentType: {
+                    type: 'string',
+                    description: 'Override content type'
+                  }
+                }
+              }
+            },
+            required: ['index']
+          }
+        });
 
           // API Config Tool
           tools.push({

package/src/utils/api_config.js

@@ -188,7 +188,8 @@ async function api_config(params, config, saveConfig) {
         
         return {
           success: true,
-          message: `Successfully updated existing API: ${api.url}`,
+          message: `Successfully updated existing API: ${api.url}. You can now execute it using: api_execute with index ${existingIndex}`,
+          index: existingIndex,
           api: apiDebugConfig.list[existingIndex],
           timestamp: new Date().toISOString()
         };
@@ -202,7 +203,8 @@ async function api_config(params, config, saveConfig) {
         
         return {
           success: true,
-          message: `Successfully added new API: ${api.url}`,
+          message: `Successfully added new API: ${api.url}. You can now execute it using: api_execute with index ${apiDebugConfig.list.length - 1}`,
+          index: apiDebugConfig.list.length - 1,
           api: api,
           timestamp: new Date().toISOString()
         };

package/src/utils/api_execute.js

@@ -0,0 +1,138 @@
+const { loadApiConfig, getAllowedMethods } = require('./api_common');
+
+/**
+ * API 执行工具 - 通过索引执行已配置的API
+ * @param {Object} params - 参数
+ * @param {number} params.index - API索引（必需）
+ * @param {Object} params.overrides - 覆盖参数（可选）
+ * @param {string} params.overrides.url - 覆盖URL
+ * @param {string} params.overrides.method - 覆盖HTTP方法
+ * @param {Object} params.overrides.headers - 覆盖请求头
+ * @param {Object} params.overrides.query - 覆盖查询参数
+ * @param {*} params.overrides.body - 覆盖请求体
+ * @param {string} params.overrides.contentType - 覆盖内容类型
+ * @param {Object} config - 服务器配置
+ * @param {Function} saveConfig - 保存配置函数
+ * @returns {Object} API执行结果
+ */
+async function api_execute(params, config, saveConfig) {
+  const { index, overrides = {} } = params || {};
+  
+  if (typeof index !== 'number' || index < 0) {
+    throw new Error('Invalid index parameter. Must be a non-negative number');
+  }
+  
+  try {
+    // 加载API配置
+    const apiDebugConfig = loadApiConfig();
+    
+    if (!apiDebugConfig.list || !Array.isArray(apiDebugConfig.list)) {
+      throw new Error('No API list found in configuration');
+    }
+    
+    if (index >= apiDebugConfig.list.length) {
+      throw new Error(`API index ${index} is out of range. Available APIs: 0-${apiDebugConfig.list.length - 1}`);
+    }
+    
+    // 获取API配置
+    const apiConfig = apiDebugConfig.list[index];
+    
+    // 合并配置和覆盖参数
+    const finalConfig = {
+      url: overrides.url || apiConfig.url,
+      method: overrides.method || apiConfig.method || 'GET',
+      headers: { ...apiDebugConfig.headers, ...apiConfig.header, ...overrides.headers },
+      query: overrides.query || apiConfig.query,
+      body: overrides.body || apiConfig.body,
+      contentType: overrides.contentType || apiConfig.contentType
+    };
+    
+    // 验证HTTP方法
+    const allowedMethods = getAllowedMethods();
+    if (!allowedMethods.includes(finalConfig.method.toUpperCase())) {
+      throw new Error(`HTTP method '${finalConfig.method}' is not allowed. Allowed methods: ${allowedMethods.join(', ')}`);
+    }
+    
+    // 构建完整URL
+    let fullUrl;
+    if (finalConfig.url.startsWith('http://') || finalConfig.url.startsWith('https://')) {
+      fullUrl = finalConfig.url;
+    } else {
+      fullUrl = apiDebugConfig.baseUrl + finalConfig.url;
+    }
+    
+    // 添加查询参数
+    if (finalConfig.query && Object.keys(finalConfig.query).length > 0) {
+      const queryString = new URLSearchParams(finalConfig.query).toString();
+      fullUrl += (fullUrl.includes('?') ? '&' : '?') + queryString;
+    }
+    
+    // 准备请求选项
+    const requestOptions = {
+      method: finalConfig.method.toUpperCase(),
+      headers: finalConfig.headers
+    };
+    
+    // 处理请求体
+    if (finalConfig.body && ['POST', 'PUT', 'PATCH'].includes(finalConfig.method.toUpperCase())) {
+      if (typeof finalConfig.body === 'object') {
+        requestOptions.body = JSON.stringify(finalConfig.body);
+        if (!finalConfig.headers['Content-Type']) {
+          requestOptions.headers['Content-Type'] = 'application/json';
+        }
+      } else {
+        requestOptions.body = finalConfig.body;
+        if (finalConfig.contentType && !finalConfig.headers['Content-Type']) {
+          requestOptions.headers['Content-Type'] = finalConfig.contentType;
+        }
+      }
+    }
+    
+    // 执行请求
+    const startTime = Date.now();
+    const response = await fetch(fullUrl, requestOptions);
+    const endTime = Date.now();
+    
+    // 处理响应
+    let responseData;
+    const contentType = response.headers.get('content-type') || '';
+    
+    if (contentType.includes('application/json')) {
+      responseData = await response.json();
+    } else {
+      responseData = await response.text();
+    }
+    
+    return {
+      success: true,
+      index: index,
+      api: {
+        url: apiConfig.url,
+        method: apiConfig.method || 'GET',
+        description: apiConfig.description
+      },
+      request: {
+        url: fullUrl,
+        method: finalConfig.method,
+        headers: finalConfig.headers,
+        body: finalConfig.body,
+        query: finalConfig.query
+      },
+      response: {
+        status: response.status,
+        statusText: response.statusText,
+        headers: Object.fromEntries(response.headers.entries()),
+        data: responseData
+      },
+      timing: {
+        duration: endTime - startTime,
+        timestamp: new Date().toISOString()
+      }
+    };
+    
+  } catch (err) {
+    throw new Error(`Failed to execute API at index ${index}: ${err.message}`);
+  }
+}
+
+module.exports = api_execute;

package/src/utils/api_help.js

@@ -1,10 +1,10 @@
 /**
- * API 帮助工具 - 返回API调试工具的详细说明和示例
- * @param {Object} params - 参数
- * @param {string} params.tool - 要查看的工具名称（可选，默认返回所有工具）
- * @param {Object} config - 服务器配置
- * @param {Function} saveConfig - 保存配置函数
- * @returns {Object} 工具说明和示例
+ * API Help Tool - Returns detailed documentation and examples for API debugging tools
+ * @param {Object} params - Parameters
+ * @param {string} params.tool - Tool name to view (optional, returns all tools by default)
+ * @param {Object} config - Server configuration
+ * @param {Function} saveConfig - Save configuration function
+ * @returns {Object} Tool documentation and examples
  */
 async function api_help(params, config, saveConfig) {
   const { tool } = params || {};
@@ -12,25 +12,25 @@ async function api_help(params, config, saveConfig) {
   const helpContent = {
     api_debug: {
       name: 'api_debug',
-      description: 'API调试工具 - 直接执行API请求',
-      usage: '直接传入URL和参数即可执行API请求，无需复杂的action参数',
+      description: 'API Debug Tool - Direct API request execution',
+      usage: 'Directly pass URL and parameters to execute API requests without complex action parameters',
       supportedFormats: [
-        'JSON对象: {"username": "admin", "password": "123456"}',
-        '表单数据: "username=admin&password=123456"',
-        '纯文本: "Hello World"',
+        'JSON Object: {"username": "admin", "password": "123456"}',
+        'Form Data: "username=admin&password=123456"',
+        'Plain Text: "Hello World"',
         'XML: "<user><name>John</name><email>john@example.com</email></user>"',
         'HTML: "<html><body>Content</body></html>"'
       ],
       autoContentTypeDetection: {
-        'JSON对象': 'application/json',
-        '表单数据': 'application/x-www-form-urlencoded',
+        'JSON Object': 'application/json',
+        'Form Data': 'application/x-www-form-urlencoded',
         'XML': 'application/xml',
         'HTML': 'text/html',
-        '纯文本': 'text/plain'
+        'Plain Text': 'text/plain'
       },
       examples: [
         {
-          description: '简单GET请求',
+          description: 'Simple GET request',
           request: {
             url: '/api/users',
             method: 'GET',
@@ -38,7 +38,7 @@ async function api_help(params, config, saveConfig) {
           }
         },
         {
-          description: 'POST请求带JSON体',
+          description: 'POST request with JSON body',
           request: {
             url: '/api/login',
             method: 'POST',
@@ -47,7 +47,7 @@ async function api_help(params, config, saveConfig) {
           }
         },
         {
-          description: 'PUT请求带表单数据',
+          description: 'PUT request with form data',
           request: {
             url: '/api/users/123',
             method: 'PUT',
@@ -56,7 +56,7 @@ async function api_help(params, config, saveConfig) {
           }
         },
         {
-          description: 'DELETE请求带认证',
+          description: 'DELETE request with authentication',
           request: {
             url: '/api/users/123',
             method: 'DELETE',
@@ -65,36 +65,36 @@ async function api_help(params, config, saveConfig) {
         }
       ],
       bestPractices: [
-        '使用相对URL: /api/endpoint 而不是完整URL',
-        '通过api_config工具设置baseUrl',
-        '让工具自动检测内容类型，除非有特殊需求',
-        'GET请求使用query参数而不是body',
-        '通过headers参数设置认证信息'
+        'Use relative URLs: /api/endpoint instead of full URLs',
+        'Set baseUrl through api_config tool',
+        'Let the tool auto-detect content type unless you have special needs',
+        'Use query parameters for GET requests instead of body',
+        'Set authentication information through headers parameter'
       ]
     },
     api_login: {
       name: 'api_login',
-      description: 'API登录工具 - 使用环境变量进行登录认证',
-      usage: '无需参数，直接从环境变量获取登录信息',
+      description: 'API Login Tool - Authentication using environment variables',
+      usage: 'No parameters required, directly gets login information from environment variables',
       environmentVariables: {
-        'API_DEBUG_LOGIN_URL': '登录接口URL（默认: /api/login）',
-        'API_DEBUG_LOGIN_METHOD': '登录请求方法（默认: POST）',
-        'API_DEBUG_LOGIN_BODY': '登录请求体模板（支持JSON和字符串格式）',
-        'API_DEBUG_LOGIN_DESCRIPTION': '登录接口描述'
+        'API_DEBUG_LOGIN_URL': 'Login API URL (default: /api/login)',
+        'API_DEBUG_LOGIN_METHOD': 'Login request method (default: POST)',
+        'API_DEBUG_LOGIN_BODY': 'Login request body template (supports JSON and string formats)',
+        'API_DEBUG_LOGIN_DESCRIPTION': 'Login API description'
       },
       features: [
-        '自动从环境变量获取登录配置',
-        '支持JSON和字符串格式的登录体',
-        '自动提取token并更新Authorization头',
-        '支持自定义baseUrl参数'
+        'Automatically gets login configuration from environment variables',
+        'Supports JSON and string formats for login body',
+        'Automatically extracts token and updates Authorization header',
+        'Supports custom baseUrl parameter'
       ],
       examples: [
         {
-          description: '基本登录（使用环境变量配置）',
+          description: 'Basic login (using environment variable configuration)',
           request: {}
         },
         {
-          description: '指定baseUrl的登录',
+          description: 'Login with specified baseUrl',
           request: {
             baseUrl: 'https://api.example.com'
           }
@@ -103,57 +103,98 @@ async function api_help(params, config, saveConfig) {
     },
     api_config: {
       name: 'api_config',
-      description: 'API配置管理工具 - 管理全局API配置',
-      usage: '使用action参数指定操作类型',
+      description: 'API Configuration Management Tool - Manage global API configuration',
+      usage: 'Use action parameter to specify operation type',
       actions: {
-        'get': '获取当前配置',
-        'set': '设置完整配置',
-        'updateBaseUrl': '更新基础URL',
-        'updateHeaders': '更新请求头',
-        'deleteHeader': '删除指定请求头',
-        'addApi': '添加API端点',
-        'search': '搜索API',
-        'list': '列出所有API'
+        'get': 'Get current configuration',
+        'set': 'Set complete configuration',
+        'updateBaseUrl': 'Update base URL',
+        'updateHeaders': 'Update request headers',
+        'deleteHeader': 'Delete specified header',
+        'addApi': 'Add API endpoint',
+        'search': 'Search APIs',
+        'list': 'List all APIs'
       },
       examples: [
         {
-          description: '获取配置',
+          description: 'Get configuration',
           request: { action: 'get' }
         },
         {
-          description: '更新基础URL',
+          description: 'Update base URL',
           request: { 
             action: 'updateBaseUrl', 
             baseUrl: 'https://api.example.com' 
           }
         },
         {
-          description: '更新请求头',
+          description: 'Update request headers',
           request: { 
             action: 'updateHeaders', 
             headers: { 'Authorization': 'Bearer token123' } 
           }
         },
         {
-          description: '搜索API',
+          description: 'Search APIs',
           request: { 
             action: 'search', 
             keyword: 'user' 
           }
         },
         {
-          description: '添加API端点',
+          description: 'Add API endpoint',
           request: { 
             action: 'addApi', 
             api: {
               url: '/api/users',
               method: 'GET',
-              description: '获取用户列表',
+              description: 'Get user list',
               query: { page: 1, limit: 10 }
             }
           }
         }
       ]
+    },
+    api_execute: {
+      name: 'api_execute',
+      description: 'API Execute Tool - Execute configured APIs by index',
+      usage: 'Use index parameter to specify API index, optional overrides parameter to override configuration',
+      parameters: {
+        index: 'API index (required, non-negative integer)',
+        overrides: 'Override parameters (optional object)'
+      },
+      overrides: {
+        url: 'Override API URL',
+        method: 'Override HTTP method',
+        headers: 'Override or add request headers',
+        query: 'Override query parameters',
+        body: 'Override request body',
+        contentType: 'Override content type'
+      },
+      examples: [
+        {
+          description: 'Execute API at index 0',
+          request: { index: 0 }
+        },
+        {
+          description: 'Execute API at index 1 with method override',
+          request: { 
+            index: 1, 
+            overrides: { method: 'POST' }
+          }
+        },
+        {
+          description: 'Execute API with body and header overrides',
+          request: { 
+            index: 2, 
+            overrides: { 
+              method: 'PUT',
+              body: { name: 'New Name' },
+              headers: { 'Content-Type': 'application/json' }
+            }
+          }
+        }
+      ]
     }
   };
   
@@ -166,13 +207,14 @@ async function api_help(params, config, saveConfig) {
   } else {
     return {
       success: true,
-      message: 'API调试工具帮助文档',
+      message: 'API Debugging Tools Help Documentation',
       tools: helpContent,
       quickStart: {
-        '1. 设置配置': '使用 api_config 工具设置 baseUrl 和 headers',
-        '2. 登录认证': '使用 api_login 工具进行登录（如果需要）',
-        '3. 调试API': '使用 api_debug 工具执行API请求',
-        '4. 查看帮助': '使用 api_help 工具查看详细说明'
+        '1. Set Configuration': 'Use api_config tool to set baseUrl and headers',
+        '2. Add APIs': 'Use api_config tool with addApi action to add API endpoints',
+        '3. Login Authentication': 'Use api_login tool for authentication (if needed)',
+        '4. Execute APIs': 'Use api_execute tool to execute APIs by index, or use api_debug tool for direct execution',
+        '5. View Help': 'Use api_help tool to view detailed documentation'
       },
       timestamp: new Date().toISOString()
     };