npm - @lmcc-dev/mult-fetch-mcp-server - Versions diffs - 1.0.3 → 1.2.0 - Mend

@lmcc-dev/mult-fetch-mcp-server 1.0.3 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/README.md +11 -9
package/README.zh.md +19 -10
package/dist/i18n-test-report.json +8 -0
package/dist/i18n-unused-keys-report.json +8 -0
package/dist/src/client.js +75 -62
package/dist/src/index.js +0 -0
package/dist/src/lib/BrowserFetcher.js +12 -12
package/dist/src/lib/NodeFetcher.js +165 -106
package/dist/src/lib/fetch.js +40 -0
package/dist/src/lib/fetchers/FetcherFactory.js +43 -0
package/dist/src/lib/fetchers/browser/BrowserFetcher.js +381 -0
package/dist/src/lib/fetchers/browser/BrowserInstance.js +180 -0
package/dist/src/lib/fetchers/browser/PageOperations.js +168 -0
package/dist/src/lib/fetchers/common/types.js +41 -0
package/dist/src/lib/fetchers/common/utils.js +141 -0
package/dist/src/lib/fetchers/index.js +62 -0
package/dist/src/lib/fetchers/node/HttpClient.js +239 -0
package/dist/src/lib/fetchers/node/NodeFetcher.js +180 -0
package/dist/src/lib/i18n/index.js +105 -17
package/dist/src/lib/i18n/keys/base.js +41 -0
package/dist/src/lib/i18n/keys/browser.js +91 -0
package/dist/src/lib/i18n/keys/client.js +68 -0
package/dist/src/lib/i18n/keys/errors.js +49 -0
package/dist/src/lib/i18n/keys/factory.js +46 -0
package/dist/src/lib/i18n/keys/fetcher.js +87 -0
package/dist/src/lib/i18n/keys/index.js +16 -0
package/dist/src/lib/i18n/keys/node.js +69 -0
package/dist/src/lib/i18n/keys/prompts.js +79 -0
package/dist/src/lib/i18n/keys/resources.js +53 -0
package/dist/src/lib/i18n/keys/server.js +67 -0
package/dist/src/lib/i18n/keys/tools.js +39 -0
package/dist/src/lib/i18n/keys.js +504 -0
package/dist/src/lib/i18n/locales/en/browser.js +79 -55
package/dist/src/lib/i18n/locales/en/client.js +57 -33
package/dist/src/lib/i18n/locales/en/errors.js +36 -12
package/dist/src/lib/i18n/locales/en/factory.js +38 -0
package/dist/src/lib/i18n/locales/en/fetcher.js +67 -60
package/dist/src/lib/i18n/locales/en/index.js +9 -7
package/dist/src/lib/i18n/locales/en/node.js +57 -35
package/dist/src/lib/i18n/locales/en/prompts.js +42 -65
package/dist/src/lib/i18n/locales/en/resources.js +52 -40
package/dist/src/lib/i18n/locales/en/server.js +49 -24
package/dist/src/lib/i18n/locales/en/tools.js +27 -19
package/dist/src/lib/i18n/locales/zh/browser.js +79 -56
package/dist/src/lib/i18n/locales/zh/client.js +57 -32
package/dist/src/lib/i18n/locales/zh/errors.js +36 -12
package/dist/src/lib/i18n/locales/zh/factory.js +38 -0
package/dist/src/lib/i18n/locales/zh/fetcher.js +67 -60
package/dist/src/lib/i18n/locales/zh/index.js +9 -7
package/dist/src/lib/i18n/locales/zh/node.js +61 -36
package/dist/src/lib/i18n/locales/zh/prompts.js +35 -57
package/dist/src/lib/i18n/locales/zh/resources.js +51 -39
package/dist/src/lib/i18n/locales/zh/server.js +51 -25
package/dist/src/lib/i18n/locales/zh/tools.js +27 -19
package/dist/src/lib/i18n/logger.js +90 -19
package/dist/src/lib/logger.js +135 -14
package/dist/src/lib/server/browser.js +12 -18
package/dist/src/lib/server/fetcher.js +13 -34
package/dist/src/lib/server/index.js +2 -2
package/dist/src/lib/server/prompts.js +1 -1
package/dist/src/lib/server/resources.js +1 -1
package/dist/src/lib/server/tools.js +404 -308
package/dist/src/lib/utils/ErrorHandler.js +125 -0
package/dist/src/lib/utils/errorDetection.js +41 -0
package/dist/src/lib/utils/errors.js +279 -0
package/dist/src/mcp-server.js +0 -0
package/dist/src/test-i18n.js +139 -0
package/dist/tests/BrowserFetcher.test.js +951 -0
package/dist/tests/NodeFetcher.test.js +263 -0
package/dist/tests/client.test.js +211 -0
package/dist/tests/fetch.test.js +70 -0
package/dist/tests/fetchers/Fetcher.test.js +108 -0
package/dist/tests/fetchers/browser/BrowserFetcher.test.js +195 -0
package/dist/tests/fetchers/browser/BrowserInstance.test.js +163 -0
package/dist/tests/fetchers/node/NodeFetcher.test.js +211 -0
package/dist/tests/i18n-missing-keys.js +364 -0
package/dist/tests/i18n-remove-unused-keys.js +236 -0
package/dist/tests/i18n-test-report.json +2004 -0
package/dist/tests/i18n-unused-keys.js +425 -0
package/dist/tests/i18n.test.js +178 -0
package/dist/tests/logger.test.js +100 -0
package/dist/tests/mcp-server.test.js +113 -0
package/dist/tests/server/browser.test.js +201 -0
package/dist/tests/server/fetcher.test.js +173 -0
package/dist/tests/server/index.test.js +122 -0
package/dist/tests/server/prompts.test.js +246 -0
package/dist/tests/server/resources.test.js +395 -0
package/dist/tests/server/tools.test.js +223 -0
package/dist/tests/setup.js +36 -0
package/dist/tests/src/lib/i18n/index.js +108 -0
package/dist/tests/src/lib/i18n/keys/base.js +47 -0
package/dist/tests/src/lib/i18n/keys/browser.js +93 -0
package/dist/tests/src/lib/i18n/keys/client.js +70 -0
package/dist/tests/src/lib/i18n/keys/errors.js +34 -0
package/dist/tests/src/lib/i18n/keys/fetcher.js +84 -0
package/dist/tests/src/lib/i18n/keys/index.js +31 -0
package/dist/tests/src/lib/i18n/keys/node.js +56 -0
package/dist/tests/src/lib/i18n/keys/prompts.js +82 -0
package/dist/tests/src/lib/i18n/keys/resources.js +50 -0
package/dist/tests/src/lib/i18n/keys/server.js +64 -0
package/dist/tests/src/lib/i18n/keys/tools.js +34 -0
package/dist/tests/src/lib/i18n/locales/en/browser.js +88 -0
package/dist/tests/src/lib/i18n/locales/en/client.js +66 -0
package/dist/tests/src/lib/i18n/locales/en/errors.js +28 -0
package/dist/tests/src/lib/i18n/locales/en/fetcher.js +71 -0
package/dist/tests/src/lib/i18n/locales/en/index.js +29 -0
package/dist/tests/src/lib/i18n/locales/en/node.js +51 -0
package/dist/tests/src/lib/i18n/locales/en/prompts.js +52 -0
package/dist/tests/src/lib/i18n/locales/en/resources.js +50 -0
package/dist/tests/src/lib/i18n/locales/en/server.js +56 -0
package/dist/tests/src/lib/i18n/locales/en/tools.js +28 -0
package/dist/tests/src/lib/i18n/locales/zh/browser.js +87 -0
package/dist/tests/src/lib/i18n/locales/zh/client.js +66 -0
package/dist/tests/src/lib/i18n/locales/zh/errors.js +28 -0
package/dist/tests/src/lib/i18n/locales/zh/fetcher.js +71 -0
package/dist/tests/src/lib/i18n/locales/zh/index.js +29 -0
package/dist/tests/src/lib/i18n/locales/zh/node.js +51 -0
package/dist/tests/src/lib/i18n/locales/zh/prompts.js +53 -0
package/dist/tests/src/lib/i18n/locales/zh/resources.js +50 -0
package/dist/tests/src/lib/i18n/locales/zh/server.js +57 -0
package/dist/tests/src/lib/i18n/locales/zh/tools.js +28 -0
package/dist/tests/src/lib/i18n/logger.js +114 -0
package/dist/tests/src/lib/logger.js +181 -0
package/dist/tests/test-direct-client.js +0 -0
package/dist/tests/test-i18n.js +530 -0
package/dist/tests/test-mcp-methods.js +1 -1
package/dist/tests/test-mcp.js +0 -0
package/dist/tests/test-mini4k.js +0 -0
package/dist/tests/tests/test-i18n.js +588 -0
package/dist/tests/types.test.js +57 -0
package/dist/tests/utils/ErrorHandler.test.js +144 -0
package/dist/vitest.config.js +29 -0
package/package.json +32 -19
package/dist/src/cli-language.js +0 -78
package/dist/src/lib/example.js +0 -93
package/dist/src/lib/server/logger.js +0 -23

package/dist/tests/NodeFetcher.test.js ADDED Viewed

@@ -0,0 +1,263 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { NodeFetcher } from '../src/lib/NodeFetcher.js';
+// 模拟node-fetch
+jest.mock('node-fetch', () => {
+    const mockFetch = jest.fn();
+    // 创建模拟Response
+    const createMockResponse = (url) => {
+        // 根据URL返回不同的内容
+        let textContent = '<html><body><h1>测试页面</h1></body></html>';
+        let jsonContent = { test: 'data' };
+        let contentType = 'text/html; charset=utf-8';
+        if (url.includes('/api')) {
+            textContent = JSON.stringify(jsonContent);
+            contentType = 'application/json; charset=utf-8';
+        }
+        else if (url.includes('/text')) {
+            textContent = '这是纯文本内容';
+            contentType = 'text/plain; charset=utf-8';
+        }
+        else if (url.includes('/md')) {
+            textContent = '# 标题\n\n这是Markdown内容';
+            contentType = 'text/markdown; charset=utf-8';
+        }
+        return {
+            ok: true,
+            status: 200,
+            statusText: 'OK',
+            url: url,
+            headers: {
+                get: jest.fn((name) => {
+                    if (name.toLowerCase() === 'content-type') {
+                        return contentType;
+                    }
+                    return null;
+                }),
+                raw: () => ({}),
+                entries: () => [['content-type', contentType]]
+            },
+            text: jest.fn().mockResolvedValue(textContent),
+            json: jest.fn().mockResolvedValue(jsonContent),
+            buffer: jest.fn().mockResolvedValue(Buffer.from(textContent)),
+            clone: jest.fn(function () { return this; })
+        };
+    };
+    // 设置默认返回值
+    mockFetch.mockImplementation((url) => {
+        return Promise.resolve(createMockResponse(url));
+    });
+    return mockFetch;
+});
+// 模拟http-proxy-agent和https-proxy-agent
+jest.mock('http-proxy-agent', () => ({
+    HttpProxyAgent: jest.fn().mockImplementation(() => ({}))
+}));
+jest.mock('https-proxy-agent', () => ({
+    HttpsProxyAgent: jest.fn().mockImplementation(() => ({}))
+}));
+// 模拟child_process
+jest.mock('child_process', () => ({
+    execSync: jest.fn().mockReturnValue(Buffer.from(''))
+}));
+// 模拟i18n
+jest.mock('../src/lib/i18n/index.js', () => ({
+    t: (key, options) => {
+        return options ? `${key} ${JSON.stringify(options)}` : key;
+    }
+}));
+// 模拟logger
+jest.mock('../src/lib/logger.js', () => ({
+    log: jest.fn(),
+    COMPONENTS: {
+        NODE_FETCH: 'NODE-FETCH'
+    }
+}));
+describe('NodeFetcher类测试 (NodeFetcher Class Tests)', () => {
+    let fetch;
+    beforeEach(() => {
+        // 重置所有模拟
+        jest.clearAllMocks();
+        // 获取模拟的fetch函数
+        fetch = require('node-fetch');
+    });
+    describe('基本功能测试 (Basic Functionality Tests)', () => {
+        test('应该有html方法 (Should have html method)', () => {
+            expect(typeof NodeFetcher.html).toBe('function');
+        });
+        test('应该有json方法 (Should have json method)', () => {
+            expect(typeof NodeFetcher.json).toBe('function');
+        });
+        test('应该有txt方法 (Should have txt method)', () => {
+            expect(typeof NodeFetcher.txt).toBe('function');
+        });
+        test('应该有markdown方法 (Should have markdown method)', () => {
+            expect(typeof NodeFetcher.markdown).toBe('function');
+        });
+    });
+    describe('html方法测试 (html Method Tests)', () => {
+        test('应该能够获取HTML内容 (Should fetch HTML content)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com',
+                debug: true
+            };
+            // 调用方法
+            const result = await NodeFetcher.html(payload);
+            // 验证结果
+            expect(result).toBeDefined();
+            expect(result.html).toBeDefined();
+            expect(result.url).toBe('https://example.com');
+            expect(result.status).toBe(200);
+            expect(result.headers).toBeDefined();
+            expect(result.html).toContain('<html>');
+            // 验证fetch被调用
+            expect(fetch).toHaveBeenCalledWith(payload.url, expect.objectContaining({
+                headers: expect.any(Object),
+                timeout: expect.any(Number)
+            }));
+        });
+        test('应该处理获取HTML时的错误 (Should handle errors when fetching HTML)', async () => {
+            // 模拟fetch失败
+            fetch.mockRejectedValueOnce(new Error('Network error'));
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com',
+                debug: true
+            };
+            // 调用方法并验证它抛出错误
+            await expect(NodeFetcher.html(payload)).rejects.toThrow('Network error');
+        });
+    });
+    describe('json方法测试 (json Method Tests)', () => {
+        test('应该能够获取JSON内容 (Should fetch JSON content)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/api',
+                debug: true
+            };
+            // 调用方法
+            const result = await NodeFetcher.json(payload);
+            // 验证结果
+            expect(result).toBeDefined();
+            expect(result.json).toBeDefined();
+            expect(result.json).toEqual({ test: 'data' });
+            expect(result.url).toBe('https://example.com/api');
+            expect(result.status).toBe(200);
+            expect(result.headers).toBeDefined();
+            // 验证fetch被调用
+            expect(fetch).toHaveBeenCalledWith(payload.url, expect.objectContaining({
+                headers: expect.any(Object),
+                timeout: expect.any(Number)
+            }));
+        });
+        test('应该处理获取JSON时的错误 (Should handle errors when fetching JSON)', async () => {
+            // 模拟fetch失败
+            fetch.mockRejectedValueOnce(new Error('Network error'));
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/api',
+                debug: true
+            };
+            // 调用方法并验证它抛出错误
+            await expect(NodeFetcher.json(payload)).rejects.toThrow('Network error');
+        });
+    });
+    describe('txt方法测试 (txt Method Tests)', () => {
+        test('应该能够获取文本内容 (Should fetch text content)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/text',
+                debug: true
+            };
+            // 调用方法
+            const result = await NodeFetcher.txt(payload);
+            // 验证结果
+            expect(result).toBeDefined();
+            expect(result.text).toBeDefined();
+            expect(result.url).toBe('https://example.com/text');
+            expect(result.status).toBe(200);
+            expect(result.headers).toBeDefined();
+            // 验证fetch被调用
+            expect(fetch).toHaveBeenCalledWith(payload.url, expect.objectContaining({
+                headers: expect.any(Object),
+                timeout: expect.any(Number)
+            }));
+        });
+        test('应该处理获取文本时的错误 (Should handle errors when fetching text)', async () => {
+            // 模拟fetch失败
+            fetch.mockRejectedValueOnce(new Error('Network error'));
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/text',
+                debug: true
+            };
+            // 调用方法并验证它抛出错误
+            await expect(NodeFetcher.txt(payload)).rejects.toThrow('Network error');
+        });
+    });
+    describe('markdown方法测试 (markdown Method Tests)', () => {
+        test('应该能够获取Markdown内容 (Should fetch Markdown content)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/md',
+                debug: true
+            };
+            // 调用方法
+            const result = await NodeFetcher.markdown(payload);
+            // 验证结果
+            expect(result).toBeDefined();
+            expect(result.markdown).toBeDefined();
+            expect(result.url).toBe('https://example.com/md');
+            expect(result.status).toBe(200);
+            expect(result.headers).toBeDefined();
+            // 验证fetch被调用
+            expect(fetch).toHaveBeenCalledWith(payload.url, expect.objectContaining({
+                headers: expect.any(Object),
+                timeout: expect.any(Number)
+            }));
+        });
+        test('应该处理获取Markdown时的错误 (Should handle errors when fetching Markdown)', async () => {
+            // 模拟fetch失败
+            fetch.mockRejectedValueOnce(new Error('Network error'));
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com/md',
+                debug: true
+            };
+            // 调用方法并验证它抛出错误
+            await expect(NodeFetcher.markdown(payload)).rejects.toThrow('Network error');
+        });
+    });
+    describe('代理功能测试 (Proxy Functionality Tests)', () => {
+        test('应该正确处理HTTP代理 (Should handle HTTP proxy correctly)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'http://example.com',
+                proxy: 'http://proxy.example.com:8080',
+                debug: true
+            };
+            // 调用方法
+            await NodeFetcher.html(payload);
+            // 验证HttpProxyAgent被调用
+            const { HttpProxyAgent } = require('http-proxy-agent');
+            expect(HttpProxyAgent).toHaveBeenCalledWith(payload.proxy);
+        });
+        test('应该正确处理HTTPS代理 (Should handle HTTPS proxy correctly)', async () => {
+            // 准备测试数据
+            const payload = {
+                url: 'https://example.com',
+                proxy: 'http://proxy.example.com:8080',
+                debug: true
+            };
+            // 调用方法
+            await NodeFetcher.html(payload);
+            // 验证HttpsProxyAgent被调用
+            const { HttpsProxyAgent } = require('https-proxy-agent');
+            expect(HttpsProxyAgent).toHaveBeenCalledWith(payload.proxy);
+        });
+    });
+});

package/dist/tests/client.test.js ADDED Viewed

@@ -0,0 +1,211 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { vi, describe, test, expect, beforeEach, afterAll } from 'vitest';
+// 保存原始值以便在测试后恢复
+const originalArgv = process.argv;
+const originalExit = process.exit;
+const originalStdoutWrite = process.stdout.write;
+// 模拟 logger 模块
+const mockLog = vi.fn();
+vi.mock('../src/lib/logger.js', () => ({
+    log: mockLog,
+    COMPONENTS: {
+        CLIENT: 'CLIENT',
+        SERVER: 'SERVER',
+        NODE_FETCH: 'NODE-FETCH',
+        BROWSER_FETCH: 'BROWSER-FETCH'
+    }
+}));
+// 模拟依赖模块
+vi.mock('@modelcontextprotocol/sdk/client/index.js', () => ({
+    Client: vi.fn().mockImplementation(() => ({
+        connect: vi.fn().mockResolvedValue(undefined),
+        callTool: vi.fn(),
+        close: vi.fn().mockResolvedValue(undefined)
+    }))
+}));
+vi.mock('@modelcontextprotocol/sdk/client/stdio.js', () => ({
+    StdioClientTransport: vi.fn().mockImplementation(() => ({}))
+}));
+vi.mock('child_process', () => ({
+    execSync: vi.fn()
+}));
+// 模拟 process.exit
+vi.spyOn(process, 'exit').mockImplementation((code) => {
+    console.log(`[模拟] process.exit(${code})`);
+    return undefined;
+});
+// 创建模拟的客户端模块
+const mockClientModule = {
+    responseRequiresBrowser: vi.fn((response, debug = false) => {
+        if (response.isError) {
+            const errorText = response.content[0].text.toLowerCase();
+            if (debug) {
+                mockLog('fetcher.fetchError', debug, { error: response.content[0].text }, 'CLIENT');
+                if (errorText.includes('403') || errorText.includes('forbidden')) {
+                    mockLog('errors.forbidden', debug, {}, 'CLIENT');
+                }
+            }
+            return errorText.includes('403') ||
+                errorText.includes('forbidden') ||
+                errorText.includes('cloudflare') ||
+                errorText.includes('timeout') ||
+                errorText.includes('econnrefused');
+        }
+        return false;
+    }),
+    smartFetch: vi.fn(async (params) => {
+        const mockClient = new Client({
+            name: "fetch-mcp-client",
+            version: "1.0.0"
+        });
+        await mockClient.connect(new StdioClientTransport({
+            command: 'node',
+            args: ['index.js'],
+            stderr: 'inherit'
+        }));
+        try {
+            // 使用 any 类型来避免类型错误
+            const result = await mockClient.callTool({
+                name: params.method || 'fetch_html',
+                arguments: params
+            });
+            // 确保返回值符合 ResponseType 接口
+            return {
+                isError: typeof result.isError === 'boolean' ? result.isError : false,
+                content: Array.isArray(result.content) ? result.content : [{ text: '' }]
+            };
+        }
+        finally {
+            await mockClient.close();
+        }
+    }),
+    main: vi.fn(() => {
+        // 检查命令行参数
+        if (process.argv.length < 4) {
+            mockLog('client.usageInfo', true, {}, 'CLIENT');
+            mockLog('client.exampleUsage', true, {}, 'CLIENT');
+            process.exit(1);
+            return;
+        }
+        const method = process.argv[2];
+        let paramsJson = process.argv[3];
+        try {
+            JSON.parse(paramsJson);
+        }
+        catch (error) {
+            mockLog('client.invalidJson', true, {}, 'CLIENT');
+            process.exit(1);
+            return;
+        }
+        // 模拟成功执行
+        return;
+    })
+};
+// 模拟 client.ts 模块
+vi.mock('../src/client.ts', () => mockClientModule);
+describe('client.ts 测试', () => {
+    // 在每个测试前重置模拟
+    beforeEach(() => {
+        vi.resetModules();
+        vi.clearAllMocks();
+    });
+    // 在所有测试后恢复原始值
+    afterAll(() => {
+        process.exit = originalExit;
+        process.argv = originalArgv;
+    });
+    describe('responseRequiresBrowser 函数测试', () => {
+        test('应该在响应包含 403 错误时返回 true', () => {
+            const response = {
+                isError: true,
+                content: [{ text: '403 Forbidden' }]
+            };
+            const result = mockClientModule.responseRequiresBrowser(response, true);
+            expect(result).toBe(true);
+        });
+        test('应该在响应不是错误时返回 false', () => {
+            const response = {
+                isError: false,
+                content: [{ text: 'Success' }]
+            };
+            const result = mockClientModule.responseRequiresBrowser(response);
+            expect(result).toBe(false);
+        });
+    });
+    describe('smartFetch 函数测试', () => {
+        test('应该使用标准模式发送请求并返回结果', async () => {
+            // 模拟成功响应
+            const mockResult = {
+                isError: false,
+                content: [{ text: '<html><body>Success</body></html>' }]
+            };
+            // 设置 callTool 的返回值
+            const mockCallTool = vi.fn().mockResolvedValue(mockResult);
+            Client.mockImplementation(() => ({
+                connect: vi.fn().mockResolvedValue(undefined),
+                callTool: mockCallTool,
+                close: vi.fn().mockResolvedValue(undefined)
+            }));
+            // 调用函数
+            const result = await mockClientModule.smartFetch({
+                url: 'https://example.com',
+                debug: true
+            });
+            // 验证结果
+            expect(result).toEqual(mockResult);
+            // 验证调用
+            expect(Client).toHaveBeenCalled();
+            expect(StdioClientTransport).toHaveBeenCalled();
+            expect(mockCallTool).toHaveBeenCalledWith({
+                name: 'fetch_html',
+                arguments: expect.objectContaining({
+                    url: 'https://example.com',
+                    debug: true
+                })
+            });
+        });
+        test('应该在任何情况下都关闭客户端连接', async () => {
+            // 模拟 callTool 抛出错误
+            const mockClose = vi.fn().mockResolvedValue(undefined);
+            Client.mockImplementation(() => ({
+                connect: vi.fn().mockResolvedValue(undefined),
+                callTool: vi.fn().mockRejectedValue(new Error('Test error')),
+                close: mockClose
+            }));
+            // 调用函数并捕获错误
+            await expect(mockClientModule.smartFetch({
+                url: 'https://example.com',
+                debug: true
+            })).rejects.toThrow('Test error');
+            // 验证 close 被调用
+            expect(mockClose).toHaveBeenCalled();
+        });
+    });
+    describe('main 函数测试', () => {
+        test('应该在参数不足时显示使用信息并退出', () => {
+            // 设置命令行参数
+            process.argv = ['node', 'client.js'];
+            // 调用函数
+            mockClientModule.main();
+            // 验证日志和退出
+            expect(mockLog).toHaveBeenCalledWith('client.usageInfo', true, {}, 'CLIENT');
+            expect(mockLog).toHaveBeenCalledWith('client.exampleUsage', true, {}, 'CLIENT');
+            expect(process.exit).toHaveBeenCalledWith(1);
+        });
+        test('应该在 JSON 解析失败时显示错误并退出', () => {
+            // 设置命令行参数
+            process.argv = ['node', 'client.js', 'fetch_html', 'invalid-json'];
+            // 调用函数
+            mockClientModule.main();
+            // 验证日志和退出
+            expect(mockLog).toHaveBeenCalledWith('client.invalidJson', true, {}, 'CLIENT');
+            expect(process.exit).toHaveBeenCalledWith(1);
+        });
+    });
+});

package/dist/tests/fetch.test.js ADDED Viewed

@@ -0,0 +1,70 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { describe, expect, test, beforeEach, vi } from 'vitest';
+import { fetchHtml, fetchJson, fetchTxt, fetchMarkdown } from '../src/lib/fetch.js';
+import { Fetcher } from '../src/lib/fetchers/index.js';
+// Mock Fetcher
+vi.mock('../src/lib/fetchers/index.js', () => ({
+    Fetcher: {
+        html: vi.fn(),
+        json: vi.fn(),
+        txt: vi.fn(),
+        markdown: vi.fn()
+    }
+}));
+describe('fetch 函数测试 (fetch functions tests)', () => {
+    // 模拟响应
+    const mockResponse = {
+        content: [{ type: 'text', text: '测试内容' }],
+        isError: false
+    };
+    // 测试请求参数
+    const testPayload = {
+        url: 'https://example.com',
+        debug: true
+    };
+    beforeEach(() => {
+        // 重置所有 mock
+        vi.clearAllMocks();
+        // 设置 Fetcher 方法的返回值
+        Fetcher.html.mockResolvedValue(mockResponse);
+        Fetcher.json.mockResolvedValue(mockResponse);
+        Fetcher.txt.mockResolvedValue(mockResponse);
+        Fetcher.markdown.mockResolvedValue(mockResponse);
+    });
+    test('fetchHtml 应该调用 Fetcher.html (fetchHtml should call Fetcher.html)', async () => {
+        // 调用方法
+        const result = await fetchHtml(testPayload);
+        // 验证 Fetcher.html 被调用
+        expect(Fetcher.html).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+    });
+    test('fetchJson 应该调用 Fetcher.json (fetchJson should call Fetcher.json)', async () => {
+        // 调用方法
+        const result = await fetchJson(testPayload);
+        // 验证 Fetcher.json 被调用
+        expect(Fetcher.json).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+    });
+    test('fetchTxt 应该调用 Fetcher.txt (fetchTxt should call Fetcher.txt)', async () => {
+        // 调用方法
+        const result = await fetchTxt(testPayload);
+        // 验证 Fetcher.txt 被调用
+        expect(Fetcher.txt).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+    });
+    test('fetchMarkdown 应该调用 Fetcher.markdown (fetchMarkdown should call Fetcher.markdown)', async () => {
+        // 调用方法
+        const result = await fetchMarkdown(testPayload);
+        // 验证 Fetcher.markdown 被调用
+        expect(Fetcher.markdown).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+    });
+});

package/dist/tests/fetchers/Fetcher.test.js ADDED Viewed

@@ -0,0 +1,108 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { describe, expect, test, beforeEach, vi } from 'vitest';
+import { Fetcher } from '../../src/lib/fetchers/index.js';
+import { FetcherFactory } from '../../src/lib/fetchers/FetcherFactory.js';
+import { log, COMPONENTS } from '../../src/lib/logger.js';
+// Mock FetcherFactory
+vi.mock('../../src/lib/fetchers/FetcherFactory.js', () => ({
+    FetcherFactory: {
+        createFetcher: vi.fn()
+    }
+}));
+// Mock logger
+vi.mock('../../src/lib/logger.js', () => ({
+    log: vi.fn(),
+    COMPONENTS: {
+        SERVER: 'SERVER'
+    }
+}));
+describe('Fetcher 类测试 (Fetcher Class Tests)', () => {
+    // 模拟 fetcher 实例
+    const mockFetcher = {
+        html: vi.fn(),
+        json: vi.fn(),
+        txt: vi.fn(),
+        markdown: vi.fn()
+    };
+    // 模拟响应
+    const mockResponse = {
+        content: [{ type: 'text', text: '测试内容' }],
+        isError: false
+    };
+    // 测试请求参数
+    const testPayload = {
+        url: 'https://example.com',
+        debug: true
+    };
+    beforeEach(() => {
+        // 重置所有 mock
+        vi.clearAllMocks();
+        // 设置 FetcherFactory.createFetcher 的返回值
+        FetcherFactory.createFetcher.mockReturnValue(mockFetcher);
+        // 设置 mockFetcher 方法的返回值
+        mockFetcher.html.mockResolvedValue(mockResponse);
+        mockFetcher.json.mockResolvedValue(mockResponse);
+        mockFetcher.txt.mockResolvedValue(mockResponse);
+        mockFetcher.markdown.mockResolvedValue(mockResponse);
+    });
+    test('应该正确获取HTML内容 (Should fetch HTML content correctly)', async () => {
+        // 调用方法
+        const result = await Fetcher.html(testPayload);
+        // 验证 FetcherFactory.createFetcher 被调用
+        expect(FetcherFactory.createFetcher).toHaveBeenCalledWith(testPayload);
+        // 验证 mockFetcher.html 被调用
+        expect(mockFetcher.html).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+        // 验证日志被记录
+        expect(log).toHaveBeenCalledWith('fetcher.fetchingHtml', true, expect.objectContaining({
+            url: testPayload.url
+        }), COMPONENTS.SERVER);
+    });
+    test('应该正确获取JSON内容 (Should fetch JSON content correctly)', async () => {
+        // 调用方法
+        const result = await Fetcher.json(testPayload);
+        // 验证 FetcherFactory.createFetcher 被调用
+        expect(FetcherFactory.createFetcher).toHaveBeenCalledWith(testPayload);
+        // 验证 mockFetcher.json 被调用
+        expect(mockFetcher.json).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+        // 验证日志被记录
+        expect(log).toHaveBeenCalledWith('fetcher.fetchingJson', true, expect.objectContaining({
+            url: testPayload.url
+        }), COMPONENTS.SERVER);
+    });
+    test('应该正确获取纯文本内容 (Should fetch plain text content correctly)', async () => {
+        // 调用方法
+        const result = await Fetcher.txt(testPayload);
+        // 验证 FetcherFactory.createFetcher 被调用
+        expect(FetcherFactory.createFetcher).toHaveBeenCalledWith(testPayload);
+        // 验证 mockFetcher.txt 被调用
+        expect(mockFetcher.txt).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+        // 验证日志被记录
+        expect(log).toHaveBeenCalledWith('fetcher.fetchingTxt', true, expect.objectContaining({
+            url: testPayload.url
+        }), COMPONENTS.SERVER);
+    });
+    test('应该正确获取Markdown内容 (Should fetch Markdown content correctly)', async () => {
+        // 调用方法
+        const result = await Fetcher.markdown(testPayload);
+        // 验证 FetcherFactory.createFetcher 被调用
+        expect(FetcherFactory.createFetcher).toHaveBeenCalledWith(testPayload);
+        // 验证 mockFetcher.markdown 被调用
+        expect(mockFetcher.markdown).toHaveBeenCalledWith(testPayload);
+        // 验证返回结果
+        expect(result).toBe(mockResponse);
+        // 验证日志被记录
+        expect(log).toHaveBeenCalledWith('fetcher.fetchingMarkdown', true, expect.objectContaining({
+            url: testPayload.url
+        }), COMPONENTS.SERVER);
+    });
+});