proxy-api-mcp 1.0.0

package/dist/examples/preprocessor-usage.js

@@ -0,0 +1,196 @@
+/**
+ * 预处理器完整使用示例
+ * 演示如何在实际项目中使用预处理器功能
+ */
+import { PreprocessorRegistry, } from '../src/tools/api/index.js';
+import { logger } from '../src/utils/logger.js';
+// ========================================
+// 1. 定义自定义预处理器
+// ========================================
+/**
+ * 示例：添加API签名
+ */
+class ApiSignaturePreprocessor {
+    secretKey;
+    name = 'api_signature';
+    constructor(secretKey) {
+        this.secretKey = secretKey;
+    }
+    preprocess(requestData, context) {
+        // 生成签名
+        const timestamp = Date.now().toString();
+        const signature = this.generateSignature(requestData.url, timestamp, this.secretKey);
+        // 添加签名到请求头
+        requestData.headers['X-Timestamp'] = timestamp;
+        requestData.headers['X-Signature'] = signature;
+        logger.debug(`Added signature for tool: ${context.toolName}`);
+        return requestData;
+    }
+    generateSignature(url, timestamp, secret) {
+        // 简化的签名算法（实际应使用HMAC-SHA256等）
+        const data = `${url}${timestamp}${secret}`;
+        return Buffer.from(data).toString('base64');
+    }
+}
+/**
+ * 示例：请求限流预处理器
+ */
+class RateLimitPreprocessor {
+    name = 'rate_limit';
+    lastRequestTime = 0;
+    minInterval = 1000; // 最小间隔1秒
+    async preprocess(requestData, _context) {
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.minInterval) {
+            const waitTime = this.minInterval - timeSinceLastRequest;
+            logger.debug(`Rate limiting: waiting ${waitTime}ms`);
+            await this.sleep(waitTime);
+        }
+        this.lastRequestTime = Date.now();
+        return requestData;
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+/**
+ * 示例：环境切换预处理器
+ */
+class EnvironmentSwitchPreprocessor {
+    currentEnv;
+    name = 'env_switch';
+    constructor(currentEnv) {
+        this.currentEnv = currentEnv;
+    }
+    preprocess(requestData, _context) {
+        // 添加环境标识到请求头
+        requestData.headers['X-Environment'] = this.currentEnv;
+        // 可以根据环境修改某些参数
+        if (this.currentEnv === 'development') {
+            requestData.query.debug = 'true';
+        }
+        return requestData;
+    }
+}
+/**
+ * 示例：请求重试预处理器（添加重试标识）
+ */
+class RetryablePreprocessor {
+    name = 'retryable';
+    preprocess(requestData, context) {
+        // 添加重试标识
+        requestData.headers['X-Retryable'] = 'true';
+        requestData.headers['X-Max-Retries'] = '3';
+        // 从上下文中获取重试次数（如果存在）
+        const retryCount = context.args.retryCount || 0;
+        if (retryCount > 0) {
+            requestData.headers['X-Retry-Count'] = retryCount.toString();
+        }
+        return requestData;
+    }
+}
+// ========================================
+// 2. 注册预处理器
+// ========================================
+export function setupPreprocessors() {
+    logger.info('Setting up API preprocessors...');
+    // 注册自定义预处理器
+    PreprocessorRegistry.register(new ApiSignaturePreprocessor(process.env.API_SECRET_KEY || 'default-secret'));
+    PreprocessorRegistry.register(new RateLimitPreprocessor());
+    PreprocessorRegistry.register(new EnvironmentSwitchPreprocessor(process.env.NODE_ENV || 'development'));
+    PreprocessorRegistry.register(new RetryablePreprocessor());
+    // 也可以注册内置的示例预处理器
+    // import { 
+    //   AddTimestampPreprocessor, 
+    //   AuthTokenPreprocessor,
+    //   RequestLoggerPreprocessor 
+    // } from './tools/api/preprocessors/example.js';
+    // 
+    // PreprocessorRegistry.registerMany([
+    //   new AddTimestampPreprocessor(),
+    //   new AuthTokenPreprocessor(process.env.API_TOKEN),
+    //   new RequestLoggerPreprocessor(),
+    // ]);
+    logger.info(`Registered ${PreprocessorRegistry.getAll().length} preprocessors`);
+    logger.debug('Available preprocessors:', { preprocessors: PreprocessorRegistry.getAll() });
+}
+// ========================================
+// 3. 使用示例
+// ========================================
+export function exampleUsage() {
+    // 设置预处理器
+    setupPreprocessors();
+    // 加载API工具配置（配置文件中指定了preprocessor字段）
+    // const tools = await ApiToolLoader.loadFromFile('./api-tools.json');
+    // logger.info(`Loaded ${tools.length} API tools with preprocessor support`);
+    // 现在当调用这些API工具时，会自动应用配置的预处理器
+    // 例如，如果配置文件中某个工具指定了 "preprocessor": "api_signature"
+    // 那么在发送请求前会自动调用 ApiSignaturePreprocessor
+}
+// ========================================
+// 4. 动态预处理器示例
+// ========================================
+/**
+ * 根据配置动态创建预处理器
+ */
+export function createDynamicPreprocessor(name, config) {
+    return {
+        name,
+        preprocess(requestData, _context) {
+            // 根据配置动态添加请求头
+            if (config.headers && typeof config.headers === 'object') {
+                Object.assign(requestData.headers, config.headers);
+            }
+            // 根据配置动态添加查询参数
+            if (config.queryParams && typeof config.queryParams === 'object') {
+                Object.assign(requestData.query, config.queryParams);
+            }
+            return requestData;
+        },
+    };
+}
+// 使用动态预处理器
+export function setupDynamicPreprocessor() {
+    const dynamicPreprocessor = createDynamicPreprocessor('dynamic', {
+        headers: {
+            'X-Client': 'MCP-Client',
+            'X-Version': '1.0',
+        },
+        queryParams: {
+            source: 'mcp',
+        },
+    });
+    PreprocessorRegistry.register(dynamicPreprocessor);
+}
+// ========================================
+// 5. 预处理器组合示例
+// ========================================
+/**
+ * 组合多个预处理器的功能
+ */
+class CompositePreprocessor {
+    preprocessors;
+    name = 'composite';
+    constructor(preprocessors) {
+        this.preprocessors = preprocessors;
+    }
+    async preprocess(requestData, context) {
+        let result = requestData;
+        // 依次执行所有预处理器
+        for (const preprocessor of this.preprocessors) {
+            result = await preprocessor.preprocess(result, context);
+        }
+        return result;
+    }
+}
+// 使用示例
+export function setupCompositePreprocessor() {
+    const composite = new CompositePreprocessor([
+        new ApiSignaturePreprocessor('secret'),
+        new RateLimitPreprocessor(),
+        new RetryablePreprocessor(),
+    ]);
+    PreprocessorRegistry.register(composite);
+}
+//# sourceMappingURL=preprocessor-usage.js.map

package/dist/examples/preprocessor-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor-usage.js","sourceRoot":"","sources":["../../examples/preprocessor-usage.ts"],"names":[],"mappings":"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"}

package/dist/src/config/env.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 环境变量管理类
+ *
+ * 使用方式:
+ * 1. 在代码中导入: import { env } from '@/config/env';
+ * 2. 获取环境变量: env.get('MCP_PORT')
+ * 3. 获取所有配置: env.getAll()
+ * 4. 验证必需的环境变量: env.validate()
+ *
+ * 添加新环境变量的步骤:
+ * 1. 在 .env.example 文件中添加环境变量说明
+ * 2. 在 EnvSchema 接口中添加类型定义
+ * 3. 在 envSchema 对象中添加验证规则
+ * 4. 在 defaultValues 对象中添加默认值(可选)
+ */
+import 'dotenv/config';
+/**
+ * 环境变量类型定义
+ */
+export interface EnvSchema {
+    MCP_TRANSPORT: 'stdio' | 'sse' | 'http';
+    MCP_PORT: number;
+    MCP_SESSION_TIMEOUT: number;
+    MCP_LOG_LEVEL: 'debug' | 'info' | 'warn' | 'error';
+    MCP_TOOLS_DIR: string;
+    MCP_API_TOOLS_CONFIG: string;
+    MCP_JSON_CONFIG: string;
+    KINGDEE_DOMAIN: string;
+    KINGDEE_ACCT_ID: string;
+    KINGDEE_USERNAME: string;
+    KINGDEE_APP_ID: string;
+    KINGDEE_SECRET: string;
+    KINGDEE_LCID: string;
+    KINGDEE_ALGORITHM: string;
+    NODE_ENV?: 'development' | 'production' | 'test';
+}
+/**
+ * 环境变量管理类
+ */
+declare class EnvManager {
+    private env;
+    private initialized;
+    constructor();
+    /**
+     * 加载环境变量
+     */
+    private load;
+    /**
+     * 解析环境变量值
+     */
+    private parseValue;
+    /**
+     * 验证环境变量
+     * @throws Error 如果必需的环境变量缺失或验证失败
+     */
+    validate(): void;
+    /**
+     * 获取指定的环境变量
+     * @param key 环境变量名
+     * @returns 环境变量值
+     */
+    get<K extends keyof EnvSchema>(key: K): EnvSchema[K];
+    /**
+     * 获取所有环境变量
+     * @returns 所有环境变量的对象
+     */
+    getAll(): Partial<EnvSchema>;
+    /**
+     * 设置环境变量(仅用于测试)
+     * @param key 环境变量名
+     * @param value 环境变量值
+     */
+    set<K extends keyof EnvSchema>(key: K, value: EnvSchema[K]): void;
+    /**
+     * 检查环境变量是否存在
+     * @param key 环境变量名
+     * @returns 是否存在
+     */
+    has(key: keyof EnvSchema): boolean;
+    /**
+     * 获取当前运行环境
+     * @returns 运行环境
+     */
+    isProduction(): boolean;
+    isDevelopment(): boolean;
+    isTest(): boolean;
+    /**
+     * 打印环境变量配置(隐藏敏感信息)
+     */
+    print(): void;
+}
+/**
+ * 导出单例实例
+ */
+export declare const env: EnvManager;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/src/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,WAAW,SAAS;IAExB,aAAa,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC;IAGtB,oBAAoB,EAAE,MAAM,CAAC;IAG7B,eAAe,EAAE,MAAM,CAAC;IAGxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;CAClD;AA0FD;;GAEG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,WAAW,CAAS;;IAM5B;;OAEG;IACH,OAAO,CAAC,IAAI;IAgBZ;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;;OAGG;IACI,QAAQ,IAAI,IAAI;IA4BvB;;;;OAIG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAO3D;;;OAGG;IACI,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAOnC;;;;OAIG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAIxE;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,SAAS,GAAG,OAAO;IAIzC;;;OAGG;IACI,YAAY,IAAI,OAAO;IAIvB,aAAa,IAAI,OAAO;IAIxB,MAAM,IAAI,OAAO;IAIxB;;OAEG;IACI,KAAK,IAAI,IAAI;CASrB;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,YAAmB,CAAC"}

package/dist/src/config/env.js

@@ -0,0 +1,228 @@
+/**
+ * 环境变量管理类
+ *
+ * 使用方式:
+ * 1. 在代码中导入: import { env } from '@/config/env';
+ * 2. 获取环境变量: env.get('MCP_PORT')
+ * 3. 获取所有配置: env.getAll()
+ * 4. 验证必需的环境变量: env.validate()
+ *
+ * 添加新环境变量的步骤:
+ * 1. 在 .env.example 文件中添加环境变量说明
+ * 2. 在 EnvSchema 接口中添加类型定义
+ * 3. 在 envSchema 对象中添加验证规则
+ * 4. 在 defaultValues 对象中添加默认值(可选)
+ */
+import 'dotenv/config';
+import { logger } from '../utils/logger.js';
+/**
+ * 环境变量验证规则
+ */
+const envSchema = {
+    MCP_TRANSPORT: {
+        required: false,
+        validate: (value) => ['stdio', 'sse', 'http'].includes(value),
+        errorMessage: 'MCP_TRANSPORT must be one of: stdio, sse, http',
+    },
+    MCP_PORT: {
+        required: false,
+        validate: (value) => {
+            const port = parseInt(value, 10);
+            return !isNaN(port) && port > 0 && port <= 65535;
+        },
+        errorMessage: 'MCP_PORT must be a valid port number (1-65535)',
+    },
+    MCP_SESSION_TIMEOUT: {
+        required: false,
+        validate: (value) => {
+            const timeout = parseInt(value, 10);
+            return !isNaN(timeout) && timeout > 0;
+        },
+        errorMessage: 'MCP_SESSION_TIMEOUT must be a positive number',
+    },
+    MCP_LOG_LEVEL: {
+        required: false,
+        validate: (value) => ['debug', 'info', 'warn', 'error'].includes(value),
+        errorMessage: 'MCP_LOG_LEVEL must be one of: debug, info, warn, error',
+    },
+    MCP_TOOLS_DIR: {
+        required: false,
+    },
+    MCP_API_TOOLS_CONFIG: {
+        required: false,
+    },
+    MCP_JSON_CONFIG: {
+        required: false,
+    },
+    KINGDEE_DOMAIN: {
+        required: false,
+    },
+    KINGDEE_ACCT_ID: {
+        required: false,
+    },
+    KINGDEE_USERNAME: {
+        required: false,
+    },
+    KINGDEE_APP_ID: {
+        required: false,
+    },
+    KINGDEE_SECRET: {
+        required: false,
+    },
+    KINGDEE_LCID: {
+        required: false,
+    },
+    KINGDEE_ALGORITHM: {
+        required: false,
+    },
+    NODE_ENV: {
+        required: false,
+        validate: (value) => ['development', 'production', 'test'].includes(value),
+        errorMessage: 'NODE_ENV must be one of: development, production, test',
+    },
+};
+/**
+ * 环境变量默认值
+ */
+const defaultValues = {
+    MCP_TRANSPORT: 'http',
+    MCP_PORT: 3000,
+    MCP_SESSION_TIMEOUT: 3600000,
+    MCP_LOG_LEVEL: 'info',
+    MCP_TOOLS_DIR: './tools',
+    NODE_ENV: 'development',
+};
+/**
+ * 环境变量管理类
+ */
+class EnvManager {
+    env = {};
+    initialized = false;
+    constructor() {
+        this.load();
+    }
+    /**
+     * 加载环境变量
+     */
+    load() {
+        // 加载所有环境变量
+        for (const key in envSchema) {
+            const envKey = key;
+            const rawValue = process.env[envKey];
+            if (rawValue !== undefined) {
+                this.env[envKey] = this.parseValue(envKey, rawValue);
+            }
+            else if (defaultValues[envKey] !== undefined) {
+                this.env[envKey] = defaultValues[envKey];
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * 解析环境变量值
+     */
+    parseValue(key, value) {
+        // 根据类型解析值
+        switch (key) {
+            case 'MCP_PORT':
+            case 'MCP_SESSION_TIMEOUT':
+                return parseInt(value, 10);
+            default:
+                return value;
+        }
+    }
+    /**
+     * 验证环境变量
+     * @throws Error 如果必需的环境变量缺失或验证失败
+     */
+    validate() {
+        const errors = [];
+        for (const key in envSchema) {
+            const envKey = key;
+            const schema = envSchema[envKey];
+            const value = this.env[envKey];
+            // 检查必需字段
+            if (schema.required && value === undefined) {
+                errors.push(`Required environment variable ${envKey} is missing`);
+                continue;
+            }
+            // 验证值
+            if (value !== undefined && schema.validate) {
+                const isValid = schema.validate(String(value));
+                if (!isValid) {
+                    errors.push(schema.errorMessage || `Invalid value for ${envKey}`);
+                }
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(`Environment validation failed:\n${errors.join('\n')}`);
+        }
+    }
+    /**
+     * 获取指定的环境变量
+     * @param key 环境变量名
+     * @returns 环境变量值
+     */
+    get(key) {
+        if (!this.initialized) {
+            this.load();
+        }
+        return this.env[key];
+    }
+    /**
+     * 获取所有环境变量
+     * @returns 所有环境变量的对象
+     */
+    getAll() {
+        if (!this.initialized) {
+            this.load();
+        }
+        return { ...this.env };
+    }
+    /**
+     * 设置环境变量(仅用于测试)
+     * @param key 环境变量名
+     * @param value 环境变量值
+     */
+    set(key, value) {
+        this.env[key] = value;
+    }
+    /**
+     * 检查环境变量是否存在
+     * @param key 环境变量名
+     * @returns 是否存在
+     */
+    has(key) {
+        return this.env[key] !== undefined;
+    }
+    /**
+     * 获取当前运行环境
+     * @returns 运行环境
+     */
+    isProduction() {
+        return this.get('NODE_ENV') === 'production';
+    }
+    isDevelopment() {
+        return this.get('NODE_ENV') === 'development';
+    }
+    isTest() {
+        return this.get('NODE_ENV') === 'test';
+    }
+    /**
+     * 打印环境变量配置(隐藏敏感信息)
+     */
+    print() {
+        const config = this.getAll();
+        logger.info('Environment Configuration:');
+        for (const key in config) {
+            const value = config[key];
+            // 这里可以添加敏感信息过滤逻辑
+            logger.info(`  ${key}: ${value}`);
+        }
+    }
+}
+/**
+ * 导出单例实例
+ */
+export const env = new EnvManager();
+//# sourceMappingURL=env.js.map

package/dist/src/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"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"}

package/dist/src/core/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 工具注册器
+ */
+import { type ToolConfig } from '../tools/types.js';
+/**
+ * 工具注册器类
+ */
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * 注册单个工具
+     */
+    register(config: ToolConfig): void;
+    /**
+     * 批量注册工具
+     */
+    registerBatch(configs: ToolConfig[]): void;
+    /**
+     * 获取工具配置
+     */
+    get(name: string): ToolConfig | undefined;
+    /**
+     * 检查工具是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 获取所有工具名称
+     */
+    getToolNames(): string[];
+    /**
+     * 获取所有工具配置
+     */
+    getAll(): ToolConfig[];
+    /**
+     * 注销工具
+     */
+    unregister(name: string): boolean;
+    /**
+     * 清空所有工具
+     */
+    clear(): void;
+    /**
+     * 获取工具数量
+     */
+    count(): number;
+    /**
+     * 验证工具配置的完整性
+     */
+    private validateToolConfig;
+    /**
+     * 转换为 MCP 工具列表格式
+     */
+    toMcpTools(): {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    }[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAE9C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAqClC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAM1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE;IAItB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,UAAU,IAAI;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,EAAE;CAOJ"}