@mearl/mcp-server 2.0.0

package/dist/install-cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * mearl-mcp-install - 用户友好的安装命令
+ *
+ * 使用方式：
+ *   mearl-mcp-install
+ *   MEARL_EXTENSION_ID=xxx mearl-mcp-install
+ */
+export {};

package/dist/install-cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * mearl-mcp-install - 用户友好的安装命令
+ *
+ * 使用方式：
+ *   mearl-mcp-install
+ *   MEARL_EXTENSION_ID=xxx mearl-mcp-install
+ */
+import { installNativeHost } from '@mearl/native-host';
+console.log('🚀 Mearl MCP Installer\n');
+const extensionId = process.env.MEARL_EXTENSION_ID;
+// Install both host manifests so MCP and Skills integrations can coexist.
+const success = await installNativeHost({
+    mode: 'both',
+    ...(extensionId ? { extensionId } : {}),
+});
+process.exit(success ? 0 : 1);

package/dist/mcp-clients.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP 客户端配置定义
+ */
+export interface MCPClientConfig {
+    name: string;
+    configPath: string;
+    useServersFormat?: boolean;
+    useTomlFormat?: boolean;
+}
+export declare const MCP_CLIENTS: Record<string, MCPClientConfig>;
+export declare function isNpxMode(): boolean;
+export declare function getMCPServerConfig(useServersFormat?: boolean, useNpx?: boolean): any;
+/**
+ * 检测已安装的 MCP 客户端
+ * @returns 已安装的客户端 ID 列表
+ */
+export declare function detectInstalledClients(): string[];
+/**
+ * 检测单个 MCP 客户端是否已安装
+ * @param clientId 客户端 ID
+ * @returns 是否已安装
+ */
+export declare function isClientInstalled(clientId: string): boolean;

package/dist/mcp-clients.js

@@ -0,0 +1,153 @@
+/**
+ * MCP 客户端配置定义
+ */
+import { join, dirname } from 'path';
+import { homedir, platform } from 'os';
+import { existsSync } from 'fs';
+/**
+ * 获取跨平台的配置文件路径
+ * @param paths 不同平台的路径配置
+ * @returns 当前平台对应的完整路径
+ */
+function getPlatformConfigPath(paths) {
+    const os = platform();
+    const basePath = homedir();
+    if (os === 'win32' && paths.win32) {
+        return join(basePath, paths.win32);
+    }
+    else if (os === 'darwin' && paths.darwin) {
+        return join(basePath, paths.darwin);
+    }
+    else if (paths.linux) {
+        return join(basePath, paths.linux);
+    }
+    // Fallback: 使用 darwin 路径作为默认
+    return join(basePath, paths.darwin || paths.linux || paths.win32 || '');
+}
+export const MCP_CLIENTS = {
+    'vscode-copilot': {
+        name: 'VSCode Copilot',
+        configPath: getPlatformConfigPath({
+            win32: join(process.env.APPDATA || '', 'Code/User/mcp.json'),
+            darwin: 'Library/Application Support/Code/User/mcp.json',
+            linux: '.config/Code/User/mcp.json',
+        }),
+        useServersFormat: true,
+    },
+    'claude-code': {
+        name: 'Claude Code',
+        configPath: getPlatformConfigPath({
+            win32: join(process.env.APPDATA || '', 'Claude Code/mcp_config.json'),
+            darwin: '.config/claude-code/mcp_config.json',
+            linux: '.config/claude-code/mcp_config.json',
+        }),
+    },
+    cursor: {
+        name: 'Cursor',
+        configPath: getPlatformConfigPath({
+            win32: join(process.env.APPDATA || '', 'Cursor/mcp_config.json'),
+            darwin: '.cursor/mcp_config.json',
+            linux: '.cursor/mcp_config.json',
+        }),
+    },
+    qoder: {
+        name: 'Qoder',
+        configPath: getPlatformConfigPath({
+            win32: join(process.env.APPDATA || '', 'Qoder/mcp_config.json'),
+            darwin: 'Library/Application Support/Qoder/mcp_config.json',
+            linux: '.config/qoder/mcp_config.json',
+        }),
+    },
+    codex: {
+        name: 'Codex',
+        configPath: getPlatformConfigPath({
+            win32: '.codex/config.toml',
+            darwin: '.codex/config.toml',
+            linux: '.codex/config.toml',
+        }),
+        useTomlFormat: true,
+    },
+};
+// 检测是否通过 npx 运行
+export function isNpxMode() {
+    // 检查 npm_execpath 环境变量
+    const execPath = process.env.npm_execpath || '';
+    if (execPath.includes('npx')) {
+        return true;
+    }
+    // 检查 npm_config_user_agent
+    const userAgent = process.env.npm_config_user_agent || '';
+    if (userAgent.includes('npx')) {
+        return true;
+    }
+    // 检查 process.argv[1] 是否包含 _npx
+    const argv1 = process.argv[1] || '';
+    if (argv1.includes('_npx') || argv1.includes('.npm/_npx')) {
+        return true;
+    }
+    // 检查 npm_command 是否为 exec (npx 使用 npm exec)
+    const npmCommand = process.env.npm_command || '';
+    if (npmCommand === 'exec') {
+        return true;
+    }
+    return false;
+}
+// 获取 MCP Server 配置模板
+export function getMCPServerConfig(useServersFormat, useNpx) {
+    if (useServersFormat) {
+        // VS Code 格式
+        if (useNpx) {
+            return {
+                type: 'stdio',
+                command: 'npx',
+                args: ['-y', '@mearl/mcp-server'],
+            };
+        }
+        return {
+            type: 'stdio',
+            command: 'mearl-mcp-server',
+        };
+    }
+    // Claude Code/Cursor 格式
+    if (useNpx) {
+        return {
+            command: 'npx',
+            args: ['-y', '@mearl/mcp-server'],
+            env: {},
+        };
+    }
+    return {
+        command: 'mearl-mcp-server',
+        args: [],
+        env: {},
+    };
+}
+/**
+ * 检测已安装的 MCP 客户端
+ * @returns 已安装的客户端 ID 列表
+ */
+export function detectInstalledClients() {
+    const installed = [];
+    for (const [id, config] of Object.entries(MCP_CLIENTS)) {
+        // 检查配置文件的父目录是否存在
+        // 因为配置文件本身可能不存在，但如果应用已安装，其配置目录应该存在
+        const configDir = dirname(config.configPath);
+        if (existsSync(configDir)) {
+            installed.push(id);
+        }
+    }
+    return installed;
+}
+/**
+ * 检测单个 MCP 客户端是否已安装
+ * @param clientId 客户端 ID
+ * @returns 是否已安装
+ */
+export function isClientInstalled(clientId) {
+    const config = MCP_CLIENTS[clientId];
+    if (!config) {
+        return false;
+    }
+    const configDir = dirname(config.configPath);
+    return existsSync(configDir);
+}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+export interface MtopRequest {
+    id: number;
+    timestamp: string;
+    timestampMs: number;
+    method: string;
+    url: string;
+    apiName: string;
+    status: number;
+    statusText: string;
+    headers: Array<{
+        name: string;
+        value: string;
+    }>;
+    responseHeaders: Array<{
+        name: string;
+        value: string;
+    }>;
+    queryString: Record<string, string>;
+    postData: Record<string, any> | null;
+    responseBody: any;
+    duration?: number;
+    proxyData?: any;
+}
+export interface ConsoleLog {
+    level: 'log' | 'warn' | 'error' | 'info';
+    message: string;
+    timestamp: number;
+    /** 来源文件和行号，格式 "filename.js:42"，仅在可获取时存在 */
+    source?: string;
+    args: any[];
+}
+export interface WaitForRequestParams {
+    pattern: string;
+    timeout?: number;
+    includeExisting?: boolean;
+}
+export interface GetRequestsParams {
+    count?: number;
+    filter?: string;
+    since?: number;
+}
+export interface GetLogsParams {
+    level?: 'log' | 'warn' | 'error' | 'info' | 'all';
+    since?: number;
+    limit?: number;
+    filter?: string;
+}
+export interface SetMockParams {
+    apiName: string;
+    mockData: any;
+    enabled?: boolean;
+    duration?: number;
+    conditions?: Record<string, any>;
+}
+export interface GetApiSchemaParams {
+    api: string;
+    version?: string;
+}
+export interface GetSelectedElementParams {
+    includeOuterHTML?: boolean;
+    includeScreenshot?: boolean;
+}
+export interface RequestsResponse {
+    meta: {
+        /** 实际返回的请求数量 */
+        count: number;
+        /** 缓冲区中符合过滤条件的总请求数 */
+        totalMatched: number;
+        /** 缓冲区中的总请求数（未过滤） */
+        totalInBuffer: number;
+        /** 应用的过滤器（如果有） */
+        filter?: string;
+        /** 时间过滤器（秒） */
+        since?: number;
+        /** 是否包含请求/响应体 */
+        includeBody: boolean;
+        /** 是否包含请求/响应头 */
+        includeHeaders: boolean;
+        /** 提取的字段（如果有） */
+        fields?: string[];
+        /** 是否只返回键结构 */
+        keysOnly: boolean;
+    };
+    /** 请求数据列表 */
+    requests: MtopRequest[];
+}
+export interface LogsResponse {
+    meta: {
+        /** 实际返回的日志数量 */
+        count: number;
+        /** 符合过滤条件的总日志数 */
+        totalMatched: number;
+        /** 应用的日志级别过滤 */
+        level: string;
+        /** 时间过滤器（秒） */
+        since?: number;
+        /** 应用的过滤模式 */
+        filter?: string;
+    };
+    /** 日志数据列表 */
+    logs: ConsoleLog[];
+}
+export interface ScreenshotResponse {
+    meta: {
+        /** 截图格式 */
+        format: 'png' | 'jpeg';
+        /** 截图宽度 */
+        width: number;
+        /** 截图高度 */
+        height: number;
+        /** 截图数据大小（字节） */
+        size: number;
+        /** 截图的页面 URL */
+        url: string;
+        /** 截图的页面标题 */
+        title: string;
+    };
+    /** Base64 编码的截图数据 */
+    data: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+// 消息类型定义
+export {};

package/dist/uninstall.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * mearl-mcp-uninstall - 卸载清理脚本
+ *
+ * 使用方式：
+ *   npx @mearl/mcp-server --uninstall
+ *   或 mearl-mcp-uninstall (如果全局安装)
+ */
+export {};

package/dist/uninstall.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * mearl-mcp-uninstall - 卸载清理脚本
+ *
+ * 使用方式：
+ *   npx @mearl/mcp-server --uninstall
+ *   或 mearl-mcp-uninstall (如果全局安装)
+ */
+import { unlinkSync, existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir, platform } from 'os';
+import { execSync } from 'child_process';
+import prompts from 'prompts';
+import { HOST_NAME } from './constants.js';
+import { MCP_CLIENTS } from './mcp-clients.js';
+// 获取 Native Messaging Host 配置目录
+function getNativeHostDir() {
+    const os = platform();
+    if (os === 'darwin') {
+        return join(homedir(), 'Library/Application Support/Google/Chrome/NativeMessagingHosts');
+    }
+    else if (os === 'linux') {
+        return join(homedir(), '.config/google-chrome/NativeMessagingHosts');
+    }
+    else if (os === 'win32') {
+        throw new Error('Windows 需要手动删除注册表项，请参考 README.md');
+    }
+    else {
+        throw new Error(`不支持的平台: ${os}`);
+    }
+}
+// 检查是否全局安装
+function isGloballyInstalled() {
+    try {
+        const cmd = platform() === 'win32' ? 'where' : 'which';
+        execSync(`${cmd} mearl-mcp-server`, { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// 清理 MCP 配置文件中的 mearl
+function cleanMCPConfig(configPath, clientConfig) {
+    try {
+        if (!existsSync(configPath)) {
+            return false;
+        }
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        const useServersFormat = clientConfig.useServersFormat;
+        let hasConfig = false;
+        if (useServersFormat) {
+            // VS Code 格式：检查 servers
+            if (config.servers && config.servers['mearl']) {
+                delete config.servers['mearl'];
+                hasConfig = true;
+            }
+        }
+        else {
+            // Claude Code/Cursor 格式：检查 mcpServers
+            if (config.mcpServers && config.mcpServers['mearl']) {
+                delete config.mcpServers['mearl'];
+                hasConfig = true;
+            }
+        }
+        if (!hasConfig) {
+            return false;
+        }
+        // 写回文件
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return true;
+    }
+    catch (error) {
+        console.error(`   ⚠️  清理配置失败: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+// 卸载主函数
+async function uninstall() {
+    console.log('🗑️  Mearl MCP 卸载\n');
+    try {
+        // 1. 清理 Native Messaging Host 配置
+        console.log('清理 Native Messaging Host...');
+        const hostDir = getNativeHostDir();
+        const manifestPath = join(hostDir, `${HOST_NAME}.json`);
+        const wrapperPath = join(hostDir, `${HOST_NAME}-launcher.sh`);
+        let hasDeleted = false;
+        if (existsSync(manifestPath)) {
+            unlinkSync(manifestPath);
+            console.log(`✅ 删除配置文件`);
+            hasDeleted = true;
+        }
+        if (existsSync(wrapperPath)) {
+            unlinkSync(wrapperPath);
+            hasDeleted = true;
+        }
+        if (!hasDeleted) {
+            console.log('未找到配置文件');
+        }
+        // 2. 检查全局安装
+        console.log('\n检查 npm 全局安装...');
+        if (isGloballyInstalled()) {
+            console.log('⚠️  请手动卸载: npm uninstall -g @mearl/mcp-server');
+        }
+        else {
+            console.log('✅ 未检测到全局安装');
+        }
+        // 3. 清理 MCP 客户端配置
+        console.log('\n清理 MCP 客户端配置...');
+        // 检测哪些客户端有配置文件
+        const availableClients = Object.entries(MCP_CLIENTS)
+            .filter(([_, client]) => existsSync(client.configPath))
+            .map(([key, client]) => ({
+            title: client.name,
+            value: key,
+        }));
+        if (availableClients.length === 0) {
+            console.log('未找到 MCP 配置');
+        }
+        else {
+            const response = await prompts({
+                type: 'multiselect',
+                name: 'clients',
+                message: '选择要清理的客户端:',
+                choices: availableClients,
+                instructions: false,
+                hint: '空格选择，回车确认',
+            });
+            if (response.clients && response.clients.length > 0) {
+                for (const clientKey of response.clients) {
+                    const client = MCP_CLIENTS[clientKey];
+                    if (cleanMCPConfig(client.configPath, client)) {
+                        console.log(`✅ 已清理 ${client.name}`);
+                    }
+                    else {
+                        console.log(`未找到 ${client.name} 配置`);
+                    }
+                }
+            }
+            else {
+                console.log('已取消');
+            }
+        }
+        console.log('\n✅ 卸载完成！');
+    }
+    catch (error) {
+        console.error('\n❌ 卸载失败:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+uninstall();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@mearl/mcp-server",
+  "version": "2.0.0",
+  "description": "MCP Server for Mearl - enables AI to interact with Chrome browser requests and logs",
+  "mcpName": "io.github.F-loat/mearl",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "@mearl/mcp-server": "./dist/index.js",
+    "mearl-mcp-server": "./dist/index.js",
+    "mearl-mcp-configure": "./dist/configure.js",
+    "mearl-mcp-uninstall": "./dist/uninstall.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "chrome-extension",
+    "devtools",
+    "mearl",
+    "ai"
+  ],
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "prompts": "^2.4.2",
+    "@mearl/client": "2.0.0",
+    "@mearl/native-host": "2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.1",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "rm -rf dist/ && tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "setup": "pnpm build && npm link",
+    "typecheck": "tsc --noEmit"
+  }
+}