weixin-devtools-mcp 0.0.1 → 0.1.1

package/build/index.js

@@ -7,28 +7,30 @@
  * - 点击页面元素
  * - 其他自动化操作
  */
+import path from "path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 // 导入微信小程序自动化 SDK
 import automator from "miniprogram-automator";
-import path from "path";
 // 导入模块化工具系统
-import { allTools } from './tools/index.js';
-// 导入zod-to-json-schema用于schema转换
 import { zodToJsonSchema } from 'zod-to-json-schema';
+import { allTools } from './tools/index.js';
 /**
  * 全局状态管理
  */
 const state = {
-    miniProgram: null, // MiniProgram 实例
-    currentPage: null, // 当前页面实例
+    /** MiniProgram 实例 (来自 miniprogram-automator) */
+    miniProgram: null,
+    /** 当前页面实例 (来自 miniprogram-automator 的 Page 类型) */
+    currentPage: null,
     elementMap: new Map(), // uid -> ElementMapInfo 映射
     consoleStorage: {
-        consoleMessages: [],
-        exceptionMessages: [],
+        navigations: [{ messages: [], exceptions: [], timestamp: new Date().toISOString() }],
+        messageIdMap: new Map(),
         isMonitoring: false,
-        startTime: null
+        startTime: null,
+        maxNavigations: 3
     }, // Console存储
     networkStorage: {
         requests: [],
@@ -57,10 +59,41 @@ class MockResponse {
     getLines() {
         return this.lines;
     }
+    shouldIncludeSnapshot() {
+        return this.includeSnapshot;
+    }
     getAttachedImages() {
         return this.attachedImages;
     }
 }
+/**
+ * 通过 UID 获取元素的实现（index.ts 版本）
+ */
+async function getElementByUidForIndex(uid) {
+    if (!state.currentPage) {
+        throw new Error('请先连接微信开发者工具并获取当前页面');
+    }
+    const mapInfo = state.elementMap.get(uid);
+    if (!mapInfo) {
+        throw new Error(`找不到 UID: ${uid}\n` +
+            `请先调用 get_page_snapshot 工具获取页面快照`);
+    }
+    console.log(`[getElementByUid] UID: ${uid}, Selector: ${mapInfo.selector}, Index: ${mapInfo.index}`);
+    const elements = await state.currentPage.$$(mapInfo.selector);
+    if (!elements || elements.length === 0) {
+        throw new Error(`选择器 "${mapInfo.selector}" 未找到任何元素\n` +
+            `页面可能已发生变化，请重新获取快照`);
+    }
+    if (mapInfo.index >= elements.length) {
+        throw new Error(`元素索引 ${mapInfo.index} 超出范围（选择器 "${mapInfo.selector}" 共找到 ${elements.length} 个元素）\n` +
+            `页面可能已发生变化，请重新获取快照`);
+    }
+    const element = elements[mapInfo.index];
+    if (!element) {
+        throw new Error(`无法获取索引 ${mapInfo.index} 的元素`);
+    }
+    return element;
+}
 // 状态转换函数 - 将全局状态转换为ToolContext
 function createToolContext() {
     return {
@@ -68,7 +101,8 @@ function createToolContext() {
         currentPage: state.currentPage,
         elementMap: state.elementMap,
         consoleStorage: state.consoleStorage,
-        networkStorage: state.networkStorage
+        networkStorage: state.networkStorage,
+        getElementByUid: getElementByUidForIndex
     };
 }
 // 创建工具处理器映射
@@ -508,6 +542,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     state.currentPage = toolContext.currentPage;
                     state.elementMap = toolContext.elementMap;
                     state.consoleStorage = toolContext.consoleStorage;
+                    state.networkStorage = toolContext.networkStorage;
                     // 返回响应
                     const responseLines = mockResponse.getLines();
                     if (responseLines.length === 0) {
@@ -540,3 +575,4 @@ main().catch((error) => {
     console.error("Server error:", error);
     process.exit(1);
 });
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * 微信开发者工具自动化 MCP 服务器 (模块化版本)
+ * 基于 chrome-devtools-mcp 架构模式重构
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/build/server.js

@@ -6,34 +6,20 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { allTools, SimpleToolResponse } from './tools/index.js';
 import { zodToJsonSchema } from 'zod-to-json-schema';
+import { MiniProgramContext } from './MiniProgramContext.js';
+import { parseToolProfileConfig, resolveToolsByProfile } from './config/tool-profile.js';
+import { allTools, SimpleToolResponse } from './tools/index.js';
 /**
- * 全局上下文状态
+ * 全局上下文状态 - 使用 MiniProgramContext 类管理
  */
-const globalContext = {
-    miniProgram: null,
-    currentPage: null,
-    elementMap: new Map(),
-    consoleStorage: {
-        consoleMessages: [],
-        exceptionMessages: [],
-        isMonitoring: false,
-        startTime: null,
-    },
-    networkStorage: {
-        requests: [],
-        isMonitoring: false,
-        startTime: null,
-        originalMethods: {},
-    },
-};
+const globalContext = MiniProgramContext.create();
 /**
  * 创建 MCP 服务器
  */
 const server = new Server({
     name: "weixin-devtools-mcp",
-    version: "0.3.3",
+    version: "0.5.0",
 }, {
     capabilities: {
         resources: {},
@@ -44,6 +30,34 @@ const server = new Server({
  * 工具处理器映射
  */
 const toolHandlers = new Map();
+/**
+ * 被 profile 禁用的工具映射
+ */
+const disabledToolHandlers = new Map();
+/**
+ * 工具 profile 配置与激活结果
+ */
+const toolProfileConfig = parseToolProfileConfig();
+const { activeTools, disabledTools } = resolveToolsByProfile(allTools, toolProfileConfig);
+for (const [toolName, toolDefinition] of disabledTools) {
+    disabledToolHandlers.set(toolName, toolDefinition);
+}
+function getDisabledToolHint(category) {
+    return [
+        `工具类别: ${category}`,
+        `可用启用方式:`,
+        `1. --tools-profile=full (启用全部工具)`,
+        `2. --enable-categories=${category} (按类别启用)`
+    ].join('\n');
+}
+function buildSnapshotMeta() {
+    return {
+        requested: true,
+        pagePath: globalContext.currentPage?.path ?? null,
+        elementCount: globalContext.elementMap.size,
+        generatedAt: new Date().toISOString(),
+    };
+}
 /**
  * 注册工具到 MCP 服务器
  */
@@ -63,7 +77,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
         description: "微信开发者工具连接状态"
     });
     // 如果已连接，提供页面快照资源
-    if (globalContext.miniProgram && globalContext.currentPage) {
+    if (globalContext.isConnected() && globalContext.currentPage) {
         resources.push({
             uri: "weixin://page/snapshot",
             mimeType: "application/json",
@@ -78,12 +92,29 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
  */
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const url = new URL(request.params.uri);
-    if (url.pathname === "/connection/status") {
+    // 对于 weixin://connection/status, url.host="connection", url.pathname="/status"
+    // 对于 weixin://page/snapshot, url.host="page", url.pathname="/snapshot"
+    const resourcePath = `${url.host}${url.pathname}`;
+    if (resourcePath === "connection/status") {
+        const connectionStatus = await globalContext.getConnectionStatus({ refreshHealth: false });
+        const summary = globalContext.getStatusSummary();
         const status = {
-            connected: !!globalContext.miniProgram,
-            hasCurrentPage: !!globalContext.currentPage,
-            pagePath: globalContext.currentPage ? await globalContext.currentPage.path : null,
-            elementCount: globalContext.elementMap.size
+            state: connectionStatus.state,
+            connectionId: connectionStatus.connectionId,
+            connected: connectionStatus.connected,
+            hasCurrentPage: connectionStatus.hasCurrentPage,
+            pagePath: connectionStatus.pagePath,
+            strategyUsed: connectionStatus.strategyUsed,
+            endpoint: connectionStatus.endpoint,
+            health: connectionStatus.health,
+            lastError: connectionStatus.lastError,
+            lastConnectedAt: connectionStatus.lastConnectedAt,
+            lastHealthCheckAt: connectionStatus.lastHealthCheckAt,
+            elementCount: summary.elementCount,
+            consoleMonitoring: summary.consoleMonitoring,
+            consoleMessageCount: summary.consoleMessageCount,
+            networkMonitoring: summary.networkMonitoring,
+            networkRequestCount: summary.networkRequestCount
         };
         return {
             contents: [{
@@ -93,7 +124,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                 }]
         };
     }
-    if (url.pathname === "/page/snapshot") {
+    if (resourcePath === "page/snapshot") {
         if (!globalContext.currentPage) {
             throw new Error("当前没有活动页面");
         }
@@ -101,7 +132,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
             // 这里可以实现获取页面快照的逻辑
             const snapshot = {
                 path: await globalContext.currentPage.path,
-                elementCount: globalContext.elementMap.size,
+                elementCount: globalContext.getElementMap().size,
                 timestamp: new Date().toISOString()
             };
             return {
@@ -122,7 +153,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  * 处理工具列表请求
  */
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-    const tools = allTools.map(tool => ({
+    const tools = activeTools.map(tool => ({
         name: tool.name,
         description: tool.description,
         inputSchema: zodToJsonSchema(tool.schema, {
@@ -139,6 +170,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const toolName = request.params.name;
     const tool = toolHandlers.get(toolName);
     if (!tool) {
+        const disabledTool = disabledToolHandlers.get(toolName);
+        if (disabledTool) {
+            const category = disabledTool.annotations?.category;
+            const disabledMessage = category
+                ? getDisabledToolHint(category)
+                : '请使用 --tools-profile=full 启用全部工具';
+            return {
+                content: [{
+                        type: "text",
+                        text: `工具 "${toolName}" 当前未启用。\n${disabledMessage}`
+                    }],
+                isError: true
+            };
+        }
         throw new Error(`未知的工具: ${toolName}`);
     }
     try {
@@ -149,6 +194,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const toolResponse = new SimpleToolResponse();
         // 执行工具处理器
         await tool.handler(toolRequest, toolResponse, globalContext);
+        if (toolResponse.shouldIncludeSnapshot()) {
+            toolResponse.mergeStructuredContent({
+                snapshot: buildSnapshotMeta(),
+            });
+        }
         // 构建响应内容
         const content = [];
         // 添加文本响应
@@ -168,7 +218,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 mimeType: image.mimeType
             });
         }
-        return { content };
+        return {
+            content,
+            structuredContent: toolResponse.getStructuredContent(),
+        };
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
@@ -182,11 +235,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
 });
 /**
- * 注册所有工具
+ * 注册激活工具
  */
-for (const tool of allTools) {
+for (const tool of activeTools) {
     registerTool(tool);
 }
+const profileSummary = `[ToolProfile] profile=${toolProfileConfig.profile}, active=${activeTools.length}, disabled=${disabledTools.size}`;
+console.error(profileSummary);
 /**
  * 启动服务器
  */
@@ -198,3 +253,4 @@ main().catch((error) => {
     console.error("Server error:", error);
     process.exit(1);
 });
+//# sourceMappingURL=server.js.map

package/build/server.js.map

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

package/build/tools/ToolDefinition.d.ts

@@ -0,0 +1,265 @@
+/**
+ * 工具定义基础框架
+ * 参考 chrome-devtools-mcp 的设计模式
+ */
+import type { MiniProgram, Page, Element } from 'miniprogram-automator';
+import type { z } from 'zod';
+import type { ConnectionConnectResult, ConnectionRequest, ConnectionStatusSnapshot } from '../connection/index.js';
+import type { ElementMapInfo } from '../tools.js';
+/**
+ * 工具分类枚举
+ * 参考 chrome-devtools-mcp 的按类别暴露机制
+ */
+export declare enum ToolCategory {
+    CORE = "core",
+    CONSOLE = "console",
+    NETWORK = "network",
+    DEBUG = "debug"
+}
+/**
+ * 工具注解接口
+ */
+export interface ToolAnnotations {
+    category: ToolCategory;
+    audience?: string[];
+    experimental?: boolean;
+}
+/**
+ * Console日志类型（扩展到15+种类型）
+ */
+export type ConsoleMessageType = 'log' | 'debug' | 'info' | 'error' | 'warn' | 'dir' | 'dirxml' | 'table' | 'trace' | 'clear' | 'group' | 'groupCollapsed' | 'groupEnd' | 'assert' | 'count' | 'timeEnd' | 'verbose';
+/**
+ * Console消息接口（带 Stable ID）
+ */
+export interface ConsoleMessage {
+    msgid?: number;
+    type: ConsoleMessageType;
+    message?: string;
+    args: unknown[];
+    timestamp: string;
+    source?: string;
+}
+/**
+ * Exception异常信息（带 Stable ID）
+ */
+export interface ExceptionMessage {
+    msgid?: number;
+    message: string;
+    stack?: string;
+    timestamp: string;
+    source?: string;
+}
+/**
+ * 导航会话数据
+ */
+export interface NavigationSession {
+    messages: ConsoleMessage[];
+    exceptions: ExceptionMessage[];
+    timestamp: string;
+}
+/**
+ * Console数据存储（支持导航历史）
+ */
+export interface ConsoleStorage {
+    navigations: NavigationSession[];
+    messageIdMap: Map<number, ConsoleMessage | ExceptionMessage>;
+    isMonitoring: boolean;
+    startTime: string | null;
+    maxNavigations: number;
+    idGenerator?: () => number;
+}
+/**
+ * 网络请求类型
+ */
+export type NetworkRequestType = 'request' | 'uploadFile' | 'downloadFile';
+/**
+ * 网络请求信息
+ */
+export interface NetworkRequest {
+    id: string;
+    type: NetworkRequestType;
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    data?: unknown;
+    params?: Record<string, unknown>;
+    statusCode?: number;
+    response?: unknown;
+    responseHeaders?: Record<string, string>;
+    error?: string;
+    duration?: number;
+    timestamp: string;
+    completedAt?: string;
+    success: boolean;
+    pending?: boolean;
+    source?: string;
+}
+/**
+ * wx 网络方法类型
+ * 用于存储原始方法以便恢复
+ */
+export type WxNetworkMethod = ((options: Record<string, unknown>) => unknown) | undefined;
+/**
+ * 网络请求数据存储
+ */
+export interface NetworkStorage {
+    requests: NetworkRequest[];
+    isMonitoring: boolean;
+    startTime: string | null;
+    originalMethods: {
+        request?: WxNetworkMethod;
+        uploadFile?: WxNetworkMethod;
+        downloadFile?: WxNetworkMethod;
+    };
+}
+/**
+ * 工具处理器上下文
+ */
+export interface NetworkCollectorContext {
+    syncFromRemote(includePreserved: boolean): Promise<number>;
+    getRequests(options?: {
+        includePreserved?: boolean;
+        types?: NetworkRequestType[];
+        urlPattern?: string;
+        successOnly?: boolean;
+        failedOnly?: boolean;
+        since?: string;
+    }): NetworkRequest[];
+    getCurrentCount(): number;
+}
+export interface ToolContext {
+    /**
+     * 小程序实例 (miniprogram-automator的MiniProgram类型)
+     * 通过 automator.connect() 或 automator.launch() 获得
+     */
+    miniProgram: MiniProgram | null;
+    /**
+     * 当前页面实例 (miniprogram-automator的Page类型)
+     * 通过 miniProgram.currentPage() 获得
+     */
+    currentPage: Page | null;
+    elementMap: Map<string, ElementMapInfo>;
+    consoleStorage: ConsoleStorage;
+    networkStorage: NetworkStorage;
+    connectionStatus: ConnectionStatusSnapshot;
+    /**
+     * 绑定并替换 miniProgram 上的 console / exception 监听器
+     * 用于确保监听器所有权清晰（谁注册，谁解绑）
+     */
+    bindConsoleAndExceptionListeners?(handlers: {
+        consoleHandler: (msg: {
+            type?: string;
+            args?: unknown[];
+        }) => void;
+        exceptionHandler: (err: {
+            message?: string;
+            stack?: string;
+        }) => void;
+    }): void;
+    /**
+     * 获取网络收集器
+     */
+    getNetworkCollector(): NetworkCollectorContext;
+    /**
+     * 清空当前会话的网络请求
+     */
+    clearNetworkRequests(): void;
+    /**
+     * 通过 UID 获取元素
+     * 统一处理：连接检查、快照检查、元素查找、索引定位
+     * @param uid 元素的唯一标识符
+     * @returns 元素对象
+     * @throws 如果页面未连接、UID 不存在、元素未找到等
+     */
+    getElementByUid(uid: string): Promise<Element>;
+    /**
+     * 建立连接
+     */
+    connectDevtools(request: ConnectionRequest): Promise<ConnectionConnectResult>;
+    /**
+     * 重新连接
+     */
+    reconnectDevtools(request?: ConnectionRequest): Promise<ConnectionConnectResult>;
+    /**
+     * 断开连接
+     */
+    disconnectDevtools(): Promise<ConnectionStatusSnapshot>;
+    /**
+     * 获取连接状态
+     */
+    getConnectionStatus(options?: {
+        refreshHealth?: boolean;
+    }): Promise<ConnectionStatusSnapshot>;
+}
+/**
+ * 工具请求接口
+ */
+export interface ToolRequest<T = unknown> {
+    params: T;
+}
+/**
+ * 工具响应接口
+ */
+export interface StructuredSnapshotMeta {
+    requested: boolean;
+    pagePath: string | null;
+    elementCount: number;
+    generatedAt: string;
+}
+export interface StructuredContent {
+    snapshot?: StructuredSnapshotMeta;
+    [key: string]: unknown;
+}
+export interface ToolResponse {
+    appendResponseLine(text: string): void;
+    setIncludeSnapshot(include: boolean): void;
+    attachImage(data: string, mimeType: string): void;
+    shouldIncludeSnapshot(): boolean;
+    mergeStructuredContent(content: StructuredContent): void;
+    getStructuredContent(): StructuredContent;
+}
+/**
+ * 工具处理器函数类型
+ */
+export type ToolHandler<TParams> = (request: ToolRequest<TParams>, response: ToolResponse, context: ToolContext) => Promise<void>;
+/**
+ * 工具定义接口
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    schema: z.ZodTypeAny;
+    annotations?: ToolAnnotations;
+    handler: ToolHandler<unknown>;
+}
+/**
+ * 定义工具的辅助函数
+ */
+export declare function defineTool<TSchema extends z.ZodTypeAny>(definition: {
+    name: string;
+    description: string;
+    schema: TSchema;
+    annotations?: ToolAnnotations;
+    handler: ToolHandler<z.infer<TSchema>>;
+}): ToolDefinition;
+/**
+ * 简单的响应实现类
+ */
+export declare class SimpleToolResponse implements ToolResponse {
+    private responseLines;
+    private includeSnapshot;
+    private attachedImages;
+    private structuredContent;
+    appendResponseLine(text: string): void;
+    setIncludeSnapshot(include: boolean): void;
+    attachImage(data: string, mimeType: string): void;
+    mergeStructuredContent(content: StructuredContent): void;
+    getStructuredContent(): StructuredContent;
+    getResponseText(): string;
+    shouldIncludeSnapshot(): boolean;
+    getAttachedImages(): Array<{
+        data: string;
+        mimeType: string;
+    }>;
+}
+//# sourceMappingURL=ToolDefinition.d.ts.map

package/build/tools/ToolDefinition.d.ts.map

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