botbrowser-mcp 0.1.8 → 0.1.9
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/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -13,8 +13,8 @@ import { instanceTools, setManager as setInstanceManager } from './tools/instanc
|
|
|
13
13
|
import { PlaywrightMCPProxy } from './tools/playwright-mcp-proxy.js';
|
|
14
14
|
// 初始化数据库
|
|
15
15
|
initDatabase();
|
|
16
|
-
// 创建 Playwright
|
|
17
|
-
const manager = new PlaywrightManager();
|
|
16
|
+
// 创建 Playwright 管理器并导出（供 playwright-mcp-proxy 访问）
|
|
17
|
+
export const manager = new PlaywrightManager();
|
|
18
18
|
setInstanceManager(manager);
|
|
19
19
|
// 创建 Playwright MCP 代理并导出为全局变量（供 switch_browser_instance 使用）
|
|
20
20
|
export const playwrightMCPProxy = new PlaywrightMCPProxy(async () => {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,SAAS;AACT,YAAY,EAAE,CAAC;AAEf,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -30,13 +30,17 @@ export declare class PlaywrightMCPProxy {
|
|
|
30
30
|
private loadTools;
|
|
31
31
|
/**
|
|
32
32
|
* Get all tool definitions for MCP protocol
|
|
33
|
+
*
|
|
34
|
+
* Adds optional instance_id parameter to all browser tools,
|
|
35
|
+
* allowing AI agents to directly specify which browser instance to operate on.
|
|
33
36
|
*/
|
|
34
37
|
getToolDefinitions(): Record<string, any>;
|
|
35
38
|
/**
|
|
36
39
|
* Call a Playwright MCP tool
|
|
37
40
|
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
41
|
+
* If instance_id is provided in args, temporarily switches to that instance,
|
|
42
|
+
* executes the tool, then restores the previous active instance.
|
|
43
|
+
* This allows AI agents to specify which browser to operate on directly.
|
|
40
44
|
*/
|
|
41
45
|
callTool(name: string, args: any): Promise<any>;
|
|
42
46
|
/**
|
|
@@ -130,13 +130,26 @@ export class PlaywrightMCPProxy {
|
|
|
130
130
|
}
|
|
131
131
|
/**
|
|
132
132
|
* Get all tool definitions for MCP protocol
|
|
133
|
+
*
|
|
134
|
+
* Adds optional instance_id parameter to all browser tools,
|
|
135
|
+
* allowing AI agents to directly specify which browser instance to operate on.
|
|
133
136
|
*/
|
|
134
137
|
getToolDefinitions() {
|
|
135
138
|
const handlers = {};
|
|
136
139
|
for (const [name, tool] of this.tools) {
|
|
140
|
+
// Clone the original inputSchema and add instance_id parameter
|
|
141
|
+
const enhancedSchema = JSON.parse(JSON.stringify(tool.inputSchema || {}));
|
|
142
|
+
if (!enhancedSchema.properties) {
|
|
143
|
+
enhancedSchema.properties = {};
|
|
144
|
+
}
|
|
145
|
+
// Add instance_id parameter to all browser tools
|
|
146
|
+
enhancedSchema.properties.instance_id = {
|
|
147
|
+
type: 'number',
|
|
148
|
+
description: 'Optional browser instance ID to operate on. If not specified, uses the currently active instance. Use list_browser_instances to see available instances.'
|
|
149
|
+
};
|
|
137
150
|
handlers[name] = {
|
|
138
|
-
description: tool.description
|
|
139
|
-
inputSchema:
|
|
151
|
+
description: `${tool.description} (Supports multi-instance via instance_id parameter)`,
|
|
152
|
+
inputSchema: enhancedSchema,
|
|
140
153
|
handler: async (args) => {
|
|
141
154
|
return await this.callTool(name, args);
|
|
142
155
|
}
|
|
@@ -147,8 +160,9 @@ export class PlaywrightMCPProxy {
|
|
|
147
160
|
/**
|
|
148
161
|
* Call a Playwright MCP tool
|
|
149
162
|
*
|
|
150
|
-
*
|
|
151
|
-
*
|
|
163
|
+
* If instance_id is provided in args, temporarily switches to that instance,
|
|
164
|
+
* executes the tool, then restores the previous active instance.
|
|
165
|
+
* This allows AI agents to specify which browser to operate on directly.
|
|
152
166
|
*/
|
|
153
167
|
async callTool(name, args) {
|
|
154
168
|
if (!this.mcpServer) {
|
|
@@ -157,18 +171,41 @@ export class PlaywrightMCPProxy {
|
|
|
157
171
|
if (!this.tools.has(name)) {
|
|
158
172
|
throw new Error(`Unknown Playwright tool: ${name}`);
|
|
159
173
|
}
|
|
174
|
+
// Extract instance_id if provided
|
|
175
|
+
const { instance_id, ...toolArgs } = args || {};
|
|
176
|
+
let previousInstanceId = null;
|
|
177
|
+
let needsRestore = false;
|
|
160
178
|
try {
|
|
179
|
+
// If instance_id is specified, temporarily switch to that instance
|
|
180
|
+
if (instance_id !== undefined) {
|
|
181
|
+
const { PlaywrightManager } = await import('../playwright/manager.js');
|
|
182
|
+
const { manager } = await import('../index.js');
|
|
183
|
+
if (manager) {
|
|
184
|
+
// Save current active instance
|
|
185
|
+
const instances = manager.listInstances();
|
|
186
|
+
const currentActive = instances.find((i) => i.is_active);
|
|
187
|
+
if (currentActive) {
|
|
188
|
+
previousInstanceId = currentActive.id;
|
|
189
|
+
}
|
|
190
|
+
// Switch to specified instance
|
|
191
|
+
if (previousInstanceId !== instance_id) {
|
|
192
|
+
await manager.switchActive(instance_id);
|
|
193
|
+
await this.resetContext();
|
|
194
|
+
needsRestore = true;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
}
|
|
161
198
|
// Get the tools/call handler
|
|
162
199
|
const handler = this.mcpServer['_requestHandlers'].get('tools/call');
|
|
163
200
|
if (!handler) {
|
|
164
201
|
throw new Error('tools/call handler not found in MCP server');
|
|
165
202
|
}
|
|
166
|
-
// Call the tool with our arguments
|
|
203
|
+
// Call the tool with our arguments (without instance_id)
|
|
167
204
|
const result = await handler({
|
|
168
205
|
method: 'tools/call',
|
|
169
206
|
params: {
|
|
170
207
|
name,
|
|
171
|
-
arguments:
|
|
208
|
+
arguments: toolArgs
|
|
172
209
|
}
|
|
173
210
|
}, {});
|
|
174
211
|
return result;
|
|
@@ -177,6 +214,21 @@ export class PlaywrightMCPProxy {
|
|
|
177
214
|
console.error(`Playwright tool '${name}' failed:`, error);
|
|
178
215
|
throw error;
|
|
179
216
|
}
|
|
217
|
+
finally {
|
|
218
|
+
// Restore previous active instance if we switched
|
|
219
|
+
if (needsRestore && previousInstanceId !== null) {
|
|
220
|
+
try {
|
|
221
|
+
const { manager } = await import('../index.js');
|
|
222
|
+
if (manager) {
|
|
223
|
+
await manager.switchActive(previousInstanceId);
|
|
224
|
+
await this.resetContext();
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
catch (error) {
|
|
228
|
+
console.error('Failed to restore previous instance:', error);
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
}
|
|
180
232
|
}
|
|
181
233
|
/**
|
|
182
234
|
* Check if a tool exists
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playwright-mcp-proxy.js","sourceRoot":"","sources":["../../src/tools/playwright-mcp-proxy.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"playwright-mcp-proxy.js","sourceRoot":"","sources":["../../src/tools/playwright-mcp-proxy.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/readme.md
CHANGED
|
@@ -78,16 +78,40 @@ add_account(
|
|
|
78
78
|
|
|
79
79
|
# 3. 启动浏览器（自动成为活跃实例）
|
|
80
80
|
launch_browser(profile_alias: "twitter-bot", account_id: 1)
|
|
81
|
+
# 返回: Browser instance 1 launched successfully
|
|
81
82
|
|
|
82
|
-
# 4.
|
|
83
|
+
# 4. 方式1：使用活跃实例（传统方式）
|
|
83
84
|
browser_navigate(url: "https://twitter.com")
|
|
84
85
|
browser_click(element: "登录按钮")
|
|
85
86
|
|
|
86
87
|
# 5. 启动第二个实例
|
|
87
88
|
launch_browser(profile_alias: "twitter-bot", account_id: 2)
|
|
89
|
+
# 返回: Browser instance 2 launched successfully
|
|
88
90
|
|
|
89
|
-
# 6.
|
|
91
|
+
# 6. 方式2：直接指定实例ID（推荐！）
|
|
92
|
+
browser_navigate(url: "https://twitter.com", instance_id: 1) # 在实例1操作
|
|
93
|
+
browser_navigate(url: "https://facebook.com", instance_id: 2) # 在实例2操作
|
|
94
|
+
|
|
95
|
+
# 7. 方式3：切换活跃实例再操作
|
|
90
96
|
switch_browser_instance(instance_id: 1)
|
|
97
|
+
browser_click(element: "Tweet按钮") # 自动使用实例1
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### 多实例操作的两种方式
|
|
101
|
+
|
|
102
|
+
**方式1: 显式指定 instance_id（推荐）**
|
|
103
|
+
```
|
|
104
|
+
# 所有浏览器工具都支持 instance_id 参数
|
|
105
|
+
browser_navigate(url: "https://example.com", instance_id: 1)
|
|
106
|
+
browser_click(element: "按钮", ref: "abc123", instance_id: 2)
|
|
107
|
+
browser_type(element: "输入框", ref: "xyz", text: "hello", instance_id: 1)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
**方式2: 切换活跃实例**
|
|
111
|
+
```
|
|
112
|
+
switch_browser_instance(instance_id: 1)
|
|
113
|
+
browser_navigate(url: "https://example.com") # 使用实例1
|
|
114
|
+
browser_click(element: "按钮") # 使用实例1
|
|
91
115
|
```
|
|
92
116
|
|
|
93
117
|
## 可用工具 (36个)
|
|
@@ -113,6 +137,9 @@ switch_browser_instance(instance_id: 1)
|
|
|
113
137
|
- `cleanup_orphaned_instances` - 清理孤立记录
|
|
114
138
|
|
|
115
139
|
### 浏览器操作 (22个 - 来自 @playwright/mcp)
|
|
140
|
+
|
|
141
|
+
**所有浏览器工具都支持可选的 `instance_id` 参数，可直接指定要操作的浏览器实例**
|
|
142
|
+
|
|
116
143
|
- `browser_navigate` - 导航到 URL
|
|
117
144
|
- `browser_click` - 点击元素
|
|
118
145
|
- `browser_type` - 输入文本
|
|
@@ -192,11 +219,22 @@ switch_browser_instance(instance_id: 1)
|
|
|
192
219
|
- **动态上下文切换**: 使用 `PlaywrightMCPProxy` 包装 @playwright/mcp，通过 `resetContext()` 清除缓存
|
|
193
220
|
- **独立浏览器状态**: 每个实例维护独立的页面、会话和导航历史
|
|
194
221
|
- **完整配置支持**: 提供包含超时设置的完整 BrowserServerBackend 配置
|
|
222
|
+
- **直接实例指定**: 所有浏览器工具支持 `instance_id` 参数，无需切换即可操作指定实例
|
|
195
223
|
|
|
196
224
|
**工作原理:**
|
|
197
|
-
1.
|
|
198
|
-
2.
|
|
199
|
-
3.
|
|
225
|
+
1. AI Agent 调用浏览器工具时，可选提供 `instance_id` 参数
|
|
226
|
+
2. 如果提供了 `instance_id`，临时切换到该实例
|
|
227
|
+
3. 执行工具操作后，自动恢复到之前的活跃实例
|
|
228
|
+
4. 如果未提供 `instance_id`，使用当前活跃实例
|
|
229
|
+
|
|
230
|
+
**示例:**
|
|
231
|
+
```javascript
|
|
232
|
+
// 同时操作两个浏览器实例，无需显式切换
|
|
233
|
+
await browser_navigate({ url: "https://twitter.com", instance_id: 1 });
|
|
234
|
+
await browser_navigate({ url: "https://facebook.com", instance_id: 2 });
|
|
235
|
+
await browser_click({ element: "Tweet按钮", ref: "xyz", instance_id: 1 });
|
|
236
|
+
await browser_click({ element: "Post按钮", ref: "abc", instance_id: 2 });
|
|
237
|
+
```
|
|
200
238
|
|
|
201
239
|
### 元数据字段
|
|
202
240
|
|
|
@@ -234,7 +272,12 @@ SELECT * FROM browser_profiles;
|
|
|
234
272
|
A: 使用 `list_browser_instances` 查看，`is_active: 1` 的实例就是当前活跃实例。
|
|
235
273
|
|
|
236
274
|
**Q: 可以同时操作多个实例吗？**
|
|
237
|
-
A:
|
|
275
|
+
A: 可以！有两种方式：
|
|
276
|
+
1. 在每个工具调用时指定 `instance_id` 参数（推荐）
|
|
277
|
+
2. 使用 `switch_browser_instance` 切换活跃实例
|
|
278
|
+
|
|
279
|
+
**Q: 什么时候需要使用 instance_id 参数？**
|
|
280
|
+
A: 当你需要频繁在多个浏览器之间切换操作时，使用 `instance_id` 更方便，避免反复调用 `switch_browser_instance`。
|
|
238
281
|
|
|
239
282
|
**Q: Cookie 什么时候保存？**
|
|
240
283
|
A: 停止实例时（`stop_browser_instance`）会自动保存到 `storage_state_path`。
|