@creatoria/miniapp-mcp 0.1.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.
- package/README.md +469 -0
- package/dist/cli.d.ts +6 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +144 -0
- package/dist/cli.js.map +1 -0
- package/dist/config/defaults.d.ts +73 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defaults.js +118 -0
- package/dist/config/defaults.js.map +1 -0
- package/dist/config/loader.d.ts +50 -0
- package/dist/config/loader.d.ts.map +1 -0
- package/dist/config/loader.js +189 -0
- package/dist/config/loader.js.map +1 -0
- package/dist/core/element-ref.d.ts +44 -0
- package/dist/core/element-ref.d.ts.map +1 -0
- package/dist/core/element-ref.js +213 -0
- package/dist/core/element-ref.js.map +1 -0
- package/dist/core/logger.d.ts +55 -0
- package/dist/core/logger.d.ts.map +1 -0
- package/dist/core/logger.js +378 -0
- package/dist/core/logger.js.map +1 -0
- package/dist/core/output.d.ts +21 -0
- package/dist/core/output.d.ts.map +1 -0
- package/dist/core/output.js +56 -0
- package/dist/core/output.js.map +1 -0
- package/dist/core/report-generator.d.ts +24 -0
- package/dist/core/report-generator.d.ts.map +1 -0
- package/dist/core/report-generator.js +212 -0
- package/dist/core/report-generator.js.map +1 -0
- package/dist/core/session.d.ts +83 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +306 -0
- package/dist/core/session.js.map +1 -0
- package/dist/core/timeout.d.ts +49 -0
- package/dist/core/timeout.d.ts.map +1 -0
- package/dist/core/timeout.js +67 -0
- package/dist/core/timeout.js.map +1 -0
- package/dist/core/tool-logger.d.ts +83 -0
- package/dist/core/tool-logger.d.ts.map +1 -0
- package/dist/core/tool-logger.js +453 -0
- package/dist/core/tool-logger.js.map +1 -0
- package/dist/core/validation.d.ts +39 -0
- package/dist/core/validation.d.ts.map +1 -0
- package/dist/core/validation.js +93 -0
- package/dist/core/validation.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +6 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +7 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +85 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/assert.d.ts +108 -0
- package/dist/tools/assert.d.ts.map +1 -0
- package/dist/tools/assert.js +291 -0
- package/dist/tools/assert.js.map +1 -0
- package/dist/tools/automator.d.ts +45 -0
- package/dist/tools/automator.d.ts.map +1 -0
- package/dist/tools/automator.js +186 -0
- package/dist/tools/automator.js.map +1 -0
- package/dist/tools/element.d.ts +253 -0
- package/dist/tools/element.d.ts.map +1 -0
- package/dist/tools/element.js +615 -0
- package/dist/tools/element.js.map +1 -0
- package/dist/tools/index.d.ts +97 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +1565 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/miniprogram.d.ts +79 -0
- package/dist/tools/miniprogram.d.ts.map +1 -0
- package/dist/tools/miniprogram.js +245 -0
- package/dist/tools/miniprogram.js.map +1 -0
- package/dist/tools/network.d.ts +65 -0
- package/dist/tools/network.d.ts.map +1 -0
- package/dist/tools/network.js +205 -0
- package/dist/tools/network.js.map +1 -0
- package/dist/tools/page.d.ts +108 -0
- package/dist/tools/page.d.ts.map +1 -0
- package/dist/tools/page.js +307 -0
- package/dist/tools/page.js.map +1 -0
- package/dist/tools/record.d.ts +86 -0
- package/dist/tools/record.d.ts.map +1 -0
- package/dist/tools/record.js +316 -0
- package/dist/tools/record.js.map +1 -0
- package/dist/tools/snapshot.d.ts +82 -0
- package/dist/tools/snapshot.d.ts.map +1 -0
- package/dist/tools/snapshot.js +258 -0
- package/dist/tools/snapshot.js.map +1 -0
- package/dist/types.d.ts +240 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +5 -0
- package/dist/types.js.map +1 -0
- package/docs/SIMPLE_USAGE.md +210 -0
- package/docs/api/README.md +244 -0
- package/docs/api/assert.md +1015 -0
- package/docs/api/automator.md +345 -0
- package/docs/api/element.md +1454 -0
- package/docs/api/miniprogram.md +558 -0
- package/docs/api/network.md +883 -0
- package/docs/api/page.md +909 -0
- package/docs/api/record.md +963 -0
- package/docs/api/snapshot.md +792 -0
- package/docs/architecture.E-Docs.md +1359 -0
- package/docs/architecture.F1.md +720 -0
- package/docs/architecture.F2.md +871 -0
- package/docs/architecture.F3.md +905 -0
- package/docs/architecture.md +90 -0
- package/docs/charter.A1.align.yaml +170 -0
- package/docs/charter.A2.align.yaml +199 -0
- package/docs/charter.A3.align.yaml +242 -0
- package/docs/charter.A4.align.yaml +227 -0
- package/docs/charter.B1.align.yaml +179 -0
- package/docs/charter.B2.align.yaml +200 -0
- package/docs/charter.B3.align.yaml +200 -0
- package/docs/charter.B4.align.yaml +188 -0
- package/docs/charter.C1.align.yaml +190 -0
- package/docs/charter.C2.align.yaml +202 -0
- package/docs/charter.C3.align.yaml +211 -0
- package/docs/charter.C4.align.yaml +263 -0
- package/docs/charter.C5.align.yaml +220 -0
- package/docs/charter.D1.align.yaml +190 -0
- package/docs/charter.D2.align.yaml +234 -0
- package/docs/charter.D3.align.yaml +206 -0
- package/docs/charter.E-Docs.align.yaml +294 -0
- package/docs/charter.F1.align.yaml +193 -0
- package/docs/charter.F2.align.yaml +248 -0
- package/docs/charter.F3.align.yaml +287 -0
- package/docs/charter.G.align.yaml +174 -0
- package/docs/charter.align.yaml +111 -0
- package/docs/examples/session-report-usage.md +449 -0
- package/docs/maintenance.md +682 -0
- package/docs/playwright-mcp/350/260/203/347/240/224.md +53 -0
- package/docs/setup-guide.md +775 -0
- package/docs/tasks.A1.atomize.md +296 -0
- package/docs/tasks.A2.atomize.md +408 -0
- package/docs/tasks.A3.atomize.md +564 -0
- package/docs/tasks.A4.atomize.md +496 -0
- package/docs/tasks.B1.atomize.md +352 -0
- package/docs/tasks.B2.atomize.md +561 -0
- package/docs/tasks.B3.atomize.md +508 -0
- package/docs/tasks.B4.atomize.md +504 -0
- package/docs/tasks.C1.atomize.md +540 -0
- package/docs/tasks.C2.atomize.md +665 -0
- package/docs/tasks.C3.atomize.md +745 -0
- package/docs/tasks.C4.atomize.md +908 -0
- package/docs/tasks.C5.atomize.md +755 -0
- package/docs/tasks.D1.atomize.md +547 -0
- package/docs/tasks.D2.atomize.md +619 -0
- package/docs/tasks.D3.atomize.md +790 -0
- package/docs/tasks.E-Docs.atomize.md +1204 -0
- package/docs/tasks.atomize.md +189 -0
- package/docs/troubleshooting.md +855 -0
- package/docs//345/256/214/346/225/264/345/256/236/347/216/260/346/226/271/346/241/210.md +155 -0
- package/docs//345/274/200/345/217/221/344/273/273/345/212/241/350/256/241/345/210/222.md +110 -0
- package/docs//345/276/256/344/277/241/345/260/217/347/250/213/345/272/217/350/207/252/345/212/250/345/214/226API/345/256/214/346/225/264/346/226/207/346/241/243.md +894 -0
- package/docs//345/276/256/344/277/241/345/260/217/347/250/213/345/272/217/350/207/252/345/212/250/345/214/226/345/256/214/346/225/264/346/223/215/344/275/234/346/211/213/345/206/214.md +1885 -0
- package/docs//346/216/245/345/217/243/346/226/271/346/241/210.md +565 -0
- package/docs//347/254/254/344/270/200/347/211/210/346/234/254/346/226/271/346/241/210.md +380 -0
- package/package.json +87 -0
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool registration for MCP server
|
|
3
|
+
* Registers all automation tools with the MCP server
|
|
4
|
+
*
|
|
5
|
+
* Tool Categories:
|
|
6
|
+
* - Automator (4 tools): Connection and lifecycle management
|
|
7
|
+
* - MiniProgram (6 tools): Mini program-level operations
|
|
8
|
+
* - Page (8 tools): Page-level operations and data access
|
|
9
|
+
* - Element (23 tools): Element-level interactions, properties, and subclass operations
|
|
10
|
+
* - Assert (9 tools): Testing and verification utilities
|
|
11
|
+
* - Snapshot (3 tools): State capture and diagnostic utilities
|
|
12
|
+
* - Record (6 tools): Action recording and replay utilities
|
|
13
|
+
* - Network (6 tools): Network mock and testing utilities
|
|
14
|
+
*
|
|
15
|
+
* Total: 65 tools
|
|
16
|
+
*/
|
|
17
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
18
|
+
import { Tool } from '@modelcontextprotocol/sdk/types.js';
|
|
19
|
+
import type { SessionState } from '../types.js';
|
|
20
|
+
export type ToolHandler = (session: SessionState, args: any) => Promise<any>;
|
|
21
|
+
/**
|
|
22
|
+
* Tool category metadata
|
|
23
|
+
*/
|
|
24
|
+
export interface ToolCategory {
|
|
25
|
+
name: string;
|
|
26
|
+
description: string;
|
|
27
|
+
tools: Tool[];
|
|
28
|
+
handlers: Record<string, ToolHandler>;
|
|
29
|
+
}
|
|
30
|
+
export declare const AUTOMATOR_TOOLS: Tool[];
|
|
31
|
+
export declare const AUTOMATOR_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
32
|
+
export declare const MINIPROGRAM_TOOLS: Tool[];
|
|
33
|
+
export declare const MINIPROGRAM_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
34
|
+
export declare const PAGE_TOOLS: Tool[];
|
|
35
|
+
export declare const PAGE_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
36
|
+
export declare const ELEMENT_TOOLS: Tool[];
|
|
37
|
+
export declare const ELEMENT_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
38
|
+
export declare const ASSERT_TOOLS: Tool[];
|
|
39
|
+
export declare const ASSERT_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
40
|
+
export declare const SNAPSHOT_TOOLS: Tool[];
|
|
41
|
+
export declare const SNAPSHOT_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
42
|
+
export declare const RECORD_TOOLS: Tool[];
|
|
43
|
+
export declare const RECORD_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
44
|
+
export declare const NETWORK_TOOLS: Tool[];
|
|
45
|
+
export declare const NETWORK_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
46
|
+
export declare const TOOL_CATEGORIES: Record<string, ToolCategory>;
|
|
47
|
+
export declare const CORE_TOOLS: Tool[];
|
|
48
|
+
export declare const CORE_TOOL_HANDLERS: Record<string, ToolHandler>;
|
|
49
|
+
/**
|
|
50
|
+
* Validate that all tool definitions have corresponding handlers
|
|
51
|
+
*/
|
|
52
|
+
export declare function validateToolRegistration(): {
|
|
53
|
+
valid: boolean;
|
|
54
|
+
errors: string[];
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Get tool statistics
|
|
58
|
+
*/
|
|
59
|
+
export declare function getToolStats(): {
|
|
60
|
+
total: number;
|
|
61
|
+
categories: {
|
|
62
|
+
automator: number;
|
|
63
|
+
miniprogram: number;
|
|
64
|
+
page: number;
|
|
65
|
+
element: number;
|
|
66
|
+
assert: number;
|
|
67
|
+
snapshot: number;
|
|
68
|
+
record: number;
|
|
69
|
+
network: number;
|
|
70
|
+
};
|
|
71
|
+
handlers: number;
|
|
72
|
+
};
|
|
73
|
+
/**
|
|
74
|
+
* Get tool by name
|
|
75
|
+
*/
|
|
76
|
+
export declare function getToolByName(name: string): Tool | undefined;
|
|
77
|
+
/**
|
|
78
|
+
* Get tools by category
|
|
79
|
+
*/
|
|
80
|
+
export declare function getToolsByCategory(category: keyof typeof TOOL_CATEGORIES): Tool[];
|
|
81
|
+
export interface ToolRegistrationOptions {
|
|
82
|
+
capabilities?: string[];
|
|
83
|
+
sessionId: string;
|
|
84
|
+
getSession: (sessionId: string) => SessionState;
|
|
85
|
+
deleteSession?: (sessionId: string) => Promise<void>;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Supported capability names for tool registration
|
|
89
|
+
*/
|
|
90
|
+
export declare const SUPPORTED_CAPABILITIES: readonly ["core", "automator", "miniprogram", "page", "element", "assert", "snapshot", "record", "network"];
|
|
91
|
+
export type Capability = (typeof SUPPORTED_CAPABILITIES)[number];
|
|
92
|
+
/**
|
|
93
|
+
* Register tools based on enabled capabilities
|
|
94
|
+
* This function actually registers the tool handlers with the MCP server
|
|
95
|
+
*/
|
|
96
|
+
export declare function registerTools(server: Server, options: ToolRegistrationOptions): Tool[];
|
|
97
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
|