rae-playwright-mcp 0.0.1 → 0.0.2
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 +63 -21
- package/cli.js +7 -3
- package/index.js +1 -1
- package/lib/common/config.js +282 -0
- package/lib/common/config.js.map +7 -0
- package/lib/common/configLoader.js +345 -0
- package/lib/common/configLoader.js.map +7 -0
- package/lib/common/esmLoaderHost.js +105 -0
- package/lib/common/esmLoaderHost.js.map +7 -0
- package/lib/common/expectBundle.js +44 -0
- package/lib/common/expectBundle.js.map +7 -0
- package/lib/common/expectBundleImpl.js +15781 -0
- package/lib/common/expectBundleImpl.js.map +7 -0
- package/lib/common/fixtures.js +303 -0
- package/lib/common/fixtures.js.map +7 -0
- package/lib/common/globals.js +59 -0
- package/lib/common/globals.js.map +7 -0
- package/lib/common/ipc.js +61 -0
- package/lib/common/ipc.js.map +7 -0
- package/lib/common/poolBuilder.js +86 -0
- package/lib/common/poolBuilder.js.map +7 -0
- package/lib/common/process.js +133 -0
- package/lib/common/process.js.map +7 -0
- package/lib/common/suiteUtils.js +141 -0
- package/lib/common/suiteUtils.js.map +7 -0
- package/lib/common/test.js +323 -0
- package/lib/common/test.js.map +7 -0
- package/lib/common/testLoader.js +102 -0
- package/lib/common/testLoader.js.map +7 -0
- package/lib/common/testType.js +299 -0
- package/lib/common/testType.js.map +7 -0
- package/lib/common/validators.js +69 -0
- package/lib/common/validators.js.map +7 -0
- package/lib/mcp/browser/actions.d.js +17 -0
- package/lib/mcp/browser/actions.d.js.map +7 -0
- package/lib/mcp/browser/browserContextFactory.js +343 -0
- package/lib/mcp/browser/browserContextFactory.js.map +7 -0
- package/lib/mcp/browser/browserServerBackend.js +78 -0
- package/lib/mcp/browser/browserServerBackend.js.map +7 -0
- package/lib/mcp/browser/config.js +421 -0
- package/lib/mcp/browser/config.js.map +7 -0
- package/lib/mcp/browser/context.js +287 -0
- package/lib/mcp/browser/context.js.map +7 -0
- package/lib/mcp/browser/response.js +353 -0
- package/lib/mcp/browser/response.js.map +7 -0
- package/lib/mcp/browser/sessionLog.js +161 -0
- package/lib/mcp/browser/sessionLog.js.map +7 -0
- package/lib/mcp/browser/tab.js +329 -0
- package/lib/mcp/browser/tab.js.map +7 -0
- package/lib/mcp/browser/tools/common.js +64 -0
- package/lib/mcp/browser/tools/common.js.map +7 -0
- package/lib/mcp/browser/tools/console.js +45 -0
- package/lib/mcp/browser/tools/console.js.map +7 -0
- package/lib/mcp/browser/tools/dialogs.js +61 -0
- package/lib/mcp/browser/tools/dialogs.js.map +7 -0
- package/lib/mcp/browser/tools/evaluate.js +60 -0
- package/lib/mcp/browser/tools/evaluate.js.map +7 -0
- package/lib/mcp/browser/tools/files.js +59 -0
- package/lib/mcp/browser/tools/files.js.map +7 -0
- package/lib/mcp/browser/tools/form.js +64 -0
- package/lib/mcp/browser/tools/form.js.map +7 -0
- package/lib/mcp/browser/tools/install.js +70 -0
- package/lib/mcp/browser/tools/install.js.map +7 -0
- package/lib/mcp/browser/tools/keyboard.js +85 -0
- package/lib/mcp/browser/tools/keyboard.js.map +7 -0
- package/lib/mcp/browser/tools/mouse.js +108 -0
- package/lib/mcp/browser/tools/mouse.js.map +7 -0
- package/lib/mcp/browser/tools/navigate.js +63 -0
- package/lib/mcp/browser/tools/navigate.js.map +7 -0
- package/lib/mcp/browser/tools/network.js +61 -0
- package/lib/mcp/browser/tools/network.js.map +7 -0
- package/lib/mcp/browser/tools/pdf.js +49 -0
- package/lib/mcp/browser/tools/pdf.js.map +7 -0
- package/lib/mcp/browser/tools/runCode.js +78 -0
- package/lib/mcp/browser/tools/runCode.js.map +7 -0
- package/lib/mcp/browser/tools/screenshot.js +106 -0
- package/lib/mcp/browser/tools/screenshot.js.map +7 -0
- package/lib/mcp/browser/tools/snapshot.js +192 -0
- package/lib/mcp/browser/tools/snapshot.js.map +7 -0
- package/lib/mcp/browser/tools/tabs.js +68 -0
- package/lib/mcp/browser/tools/tabs.js.map +7 -0
- package/lib/mcp/browser/tools/tool.js +51 -0
- package/lib/mcp/browser/tools/tool.js.map +7 -0
- package/lib/mcp/browser/tools/tracing.js +76 -0
- package/lib/mcp/browser/tools/tracing.js.map +7 -0
- package/lib/mcp/browser/tools/utils.js +95 -0
- package/lib/mcp/browser/tools/utils.js.map +7 -0
- package/lib/mcp/browser/tools/verify.js +144 -0
- package/lib/mcp/browser/tools/verify.js.map +7 -0
- package/lib/mcp/browser/tools/wait.js +64 -0
- package/lib/mcp/browser/tools/wait.js.map +7 -0
- package/lib/mcp/browser/tools.js +83 -0
- package/lib/mcp/browser/tools.js.map +7 -0
- package/lib/mcp/browser/watchdog.js +45 -0
- package/lib/mcp/browser/watchdog.js.map +7 -0
- package/lib/mcp/config.d.js +17 -0
- package/lib/mcp/config.d.js.map +7 -0
- package/lib/mcp/config.d.ts +197 -0
- package/lib/mcp/extension/cdpRelay.js +352 -0
- package/lib/mcp/extension/cdpRelay.js.map +7 -0
- package/lib/mcp/extension/extensionContextFactory.js +77 -0
- package/lib/mcp/extension/extensionContextFactory.js.map +7 -0
- package/lib/mcp/extension/protocol.js +29 -0
- package/lib/mcp/extension/protocol.js.map +7 -0
- package/lib/mcp/index.js +62 -0
- package/lib/mcp/index.js.map +7 -0
- package/lib/mcp/log.js +36 -0
- package/lib/mcp/log.js.map +7 -0
- package/lib/mcp/program.js +94 -0
- package/lib/mcp/program.js.map +7 -0
- package/lib/mcp/sdk/exports.js +29 -0
- package/lib/mcp/sdk/exports.js.map +7 -0
- package/lib/mcp/sdk/http.js +153 -0
- package/lib/mcp/sdk/http.js.map +7 -0
- package/lib/mcp/sdk/inProcessTransport.js +72 -0
- package/lib/mcp/sdk/inProcessTransport.js.map +7 -0
- package/lib/mcp/sdk/server.js +208 -0
- package/lib/mcp/sdk/server.js.map +7 -0
- package/lib/mcp/sdk/tool.js +48 -0
- package/lib/mcp/sdk/tool.js.map +7 -0
- package/lib/mcp/test/browserBackend.js +99 -0
- package/lib/mcp/test/browserBackend.js.map +7 -0
- package/lib/mcp/test/generatorTools.js +123 -0
- package/lib/mcp/test/generatorTools.js.map +7 -0
- package/lib/mcp/test/plannerTools.js +145 -0
- package/lib/mcp/test/plannerTools.js.map +7 -0
- package/lib/mcp/test/seed.js +83 -0
- package/lib/mcp/test/seed.js.map +7 -0
- package/lib/mcp/test/streams.js +45 -0
- package/lib/mcp/test/streams.js.map +7 -0
- package/lib/mcp/test/testBackend.js +100 -0
- package/lib/mcp/test/testBackend.js.map +7 -0
- package/lib/mcp/test/testContext.js +280 -0
- package/lib/mcp/test/testContext.js.map +7 -0
- package/lib/mcp/test/testTool.js +31 -0
- package/lib/mcp/test/testTool.js.map +7 -0
- package/lib/mcp/test/testTools.js +109 -0
- package/lib/mcp/test/testTools.js.map +7 -0
- package/lib/third_party/pirates.js +63 -0
- package/lib/third_party/pirates.js.map +7 -0
- package/lib/third_party/tsconfig-loader.js +104 -0
- package/lib/third_party/tsconfig-loader.js.map +7 -0
- package/lib/transform/babelBundle.js +44 -0
- package/lib/transform/babelBundle.js.map +7 -0
- package/lib/transform/babelBundleImpl.js +68726 -0
- package/lib/transform/babelBundleImpl.js.map +7 -0
- package/lib/transform/babelHighlightUtils.js +64 -0
- package/lib/transform/babelHighlightUtils.js.map +7 -0
- package/lib/transform/compilationCache.js +273 -0
- package/lib/transform/compilationCache.js.map +7 -0
- package/lib/transform/esmLoader.js +104 -0
- package/lib/transform/esmLoader.js.map +7 -0
- package/lib/transform/portTransport.js +68 -0
- package/lib/transform/portTransport.js.map +7 -0
- package/lib/transform/transform.js +297 -0
- package/lib/transform/transform.js.map +7 -0
- package/lib/util.js +404 -0
- package/lib/utilsBundle.js +44 -0
- package/lib/utilsBundleImpl.js +13122 -0
- package/package.json +4 -3
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../src/mcp/log.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { debug } from 'playwright-core/lib/utilsBundle';\n\nconst errorDebug = debug('pw:mcp:error');\n\nexport function logUnhandledError(error: unknown) {\n errorDebug(error);\n}\n\nexport const testDebug = debug('pw:mcp:test');\n"],
|
|
5
|
+
"mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,yBAAsB;AAEtB,MAAM,iBAAa,0BAAM,cAAc;AAEhC,SAAS,kBAAkB,OAAgB;AAChD,aAAW,KAAK;AAClB;AAEO,MAAM,gBAAY,0BAAM,aAAa;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __create = Object.create;
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
5
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
6
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
7
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
8
|
+
var __export = (target, all) => {
|
|
9
|
+
for (var name in all)
|
|
10
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
11
|
+
};
|
|
12
|
+
var __copyProps = (to, from, except, desc) => {
|
|
13
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
14
|
+
for (let key of __getOwnPropNames(from))
|
|
15
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
16
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
17
|
+
}
|
|
18
|
+
return to;
|
|
19
|
+
};
|
|
20
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
21
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
22
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
23
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
24
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
25
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
26
|
+
mod
|
|
27
|
+
));
|
|
28
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
29
|
+
var program_exports = {};
|
|
30
|
+
__export(program_exports, {
|
|
31
|
+
decorateCommand: () => decorateCommand
|
|
32
|
+
});
|
|
33
|
+
module.exports = __toCommonJS(program_exports);
|
|
34
|
+
var import_fs = __toESM(require("fs"));
|
|
35
|
+
var import_utilsBundle = require("playwright-core/lib/utilsBundle");
|
|
36
|
+
var import_server = require("playwright-core/lib/server");
|
|
37
|
+
var mcpServer = __toESM(require("./sdk/server"));
|
|
38
|
+
var import_config = require("./browser/config");
|
|
39
|
+
var import_watchdog = require("./browser/watchdog");
|
|
40
|
+
var import_browserContextFactory = require("./browser/browserContextFactory");
|
|
41
|
+
var import_browserServerBackend = require("./browser/browserServerBackend");
|
|
42
|
+
var import_extensionContextFactory = require("./extension/extensionContextFactory");
|
|
43
|
+
function decorateCommand(command, version) {
|
|
44
|
+
command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).option("--run-id <id>", "External UUID to use for HAR directory. If not provided, a UUID will be generated.").addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
|
|
45
|
+
(0, import_watchdog.setupExitWatchdog)();
|
|
46
|
+
if (options.vision) {
|
|
47
|
+
console.error("The --vision option is deprecated, use --caps=vision instead");
|
|
48
|
+
options.caps = "vision";
|
|
49
|
+
}
|
|
50
|
+
const config = await (0, import_config.resolveCLIConfig)(options);
|
|
51
|
+
if (config.saveVideo && !checkFfmpeg()) {
|
|
52
|
+
console.error(import_utilsBundle.colors.red(`
|
|
53
|
+
Error: ffmpeg required to save the video is not installed.`));
|
|
54
|
+
console.error(`
|
|
55
|
+
Please run the command below. It will install a local copy of ffmpeg and will not change any system-wide settings.`);
|
|
56
|
+
console.error(`
|
|
57
|
+
npx playwright install ffmpeg
|
|
58
|
+
`);
|
|
59
|
+
process.exit(1);
|
|
60
|
+
}
|
|
61
|
+
const browserContextFactory = (0, import_browserContextFactory.contextFactory)(config);
|
|
62
|
+
const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath);
|
|
63
|
+
if (options.extension) {
|
|
64
|
+
const serverBackendFactory = {
|
|
65
|
+
name: "Playwright w/ extension",
|
|
66
|
+
nameInConfig: "playwright-extension",
|
|
67
|
+
version,
|
|
68
|
+
create: () => new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory)
|
|
69
|
+
};
|
|
70
|
+
await mcpServer.start(serverBackendFactory, config.server);
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
const factory = {
|
|
74
|
+
name: "Playwright",
|
|
75
|
+
nameInConfig: "playwright",
|
|
76
|
+
version,
|
|
77
|
+
create: () => new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory)
|
|
78
|
+
};
|
|
79
|
+
await mcpServer.start(factory, config.server);
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
function checkFfmpeg() {
|
|
83
|
+
try {
|
|
84
|
+
const executable = import_server.registry.findExecutable("ffmpeg");
|
|
85
|
+
return import_fs.default.existsSync(executable.executablePath("javascript"));
|
|
86
|
+
} catch (error) {
|
|
87
|
+
return false;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
91
|
+
0 && (module.exports = {
|
|
92
|
+
decorateCommand
|
|
93
|
+
});
|
|
94
|
+
//# sourceMappingURL=program.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../src/mcp/program.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/* eslint-disable no-console */\n\nimport fs from 'fs';\n\nimport { colors, ProgramOption } from 'playwright-core/lib/utilsBundle';\nimport { registry } from 'playwright-core/lib/server';\n\nimport * as mcpServer from './sdk/server';\nimport { commaSeparatedList, dotenvFileLoader, enumParser, headerParser, numberParser, resolutionParser, resolveCLIConfig, semicolonSeparatedList } from './browser/config';\nimport { setupExitWatchdog } from './browser/watchdog';\nimport { contextFactory } from './browser/browserContextFactory';\nimport { BrowserServerBackend } from './browser/browserServerBackend';\nimport { ExtensionContextFactory } from './extension/extensionContextFactory';\n\nimport type { Command } from 'playwright-core/lib/utilsBundle';\n\nexport function decorateCommand(command: Command, version: string) {\n command\n .option('--allowed-hosts <hosts...>', 'comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass \\'*\\' to disable the host check.', commaSeparatedList)\n .option('--allowed-origins <origins>', 'semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ', semicolonSeparatedList)\n .option('--blocked-origins <origins>', 'semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\\nImportant: *does not* serve as a security boundary and *does not* affect redirects.', semicolonSeparatedList)\n .option('--block-service-workers', 'block service workers')\n .option('--browser <browser>', 'browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.')\n .option('--caps <caps>', 'comma-separated list of additional capabilities to enable, possible values: vision, pdf.', commaSeparatedList)\n .option('--cdp-endpoint <endpoint>', 'CDP endpoint to connect to.')\n .option('--cdp-header <headers...>', 'CDP headers to send with the connect request, multiple can be specified.', headerParser)\n .option('--config <path>', 'path to the configuration file.')\n .option('--console-level <level>', 'level of console messages to return: \"error\", \"warning\", \"info\", \"debug\". Each level includes the messages of more severe levels.', enumParser.bind(null, '--console-level', ['error', 'warning', 'info', 'debug']))\n .option('--device <device>', 'device to emulate, for example: \"iPhone 15\"')\n .option('--executable-path <path>', 'path to the browser executable.')\n .option('--extension', 'Connect to a running browser instance (Edge/Chrome only). Requires the \"Playwright MCP Bridge\" browser extension to be installed.')\n .option('--grant-permissions <permissions...>', 'List of permissions to grant to the browser context, for example \"geolocation\", \"clipboard-read\", \"clipboard-write\".', commaSeparatedList)\n .option('--headless', 'run browser in headless mode, headed by default')\n .option('--host <host>', 'host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.')\n .option('--ignore-https-errors', 'ignore https errors')\n .option('--init-page <path...>', 'path to TypeScript file to evaluate on Playwright page object')\n .option('--init-script <path...>', 'path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page\\'s scripts. Can be specified multiple times.')\n .option('--isolated', 'keep the browser profile in memory, do not save it to disk.')\n .option('--image-responses <mode>', 'whether to send image responses to the client. Can be \"allow\" or \"omit\", Defaults to \"allow\".', enumParser.bind(null, '--image-responses', ['allow', 'omit']))\n .option('--no-sandbox', 'disable the sandbox for all process types that are normally sandboxed.')\n .option('--output-dir <path>', 'path to the directory for output files.')\n .option('--port <port>', 'port to listen on for SSE transport.')\n .option('--proxy-bypass <bypass>', 'comma-separated domains to bypass proxy, for example \".com,chromium.org,.domain.com\"')\n .option('--proxy-server <proxy>', 'specify proxy server, for example \"http://myproxy:3128\" or \"socks5://myproxy:8080\"')\n .option('--save-session', 'Whether to save the Playwright MCP session into the output directory.')\n .option('--save-trace', 'Whether to save the Playwright Trace of the session into the output directory.')\n .option('--save-video <size>', 'Whether to save the video of the session into the output directory. For example \"--save-video=800x600\"', resolutionParser.bind(null, '--save-video'))\n .option('--secrets <path>', 'path to a file containing secrets in the dotenv format', dotenvFileLoader)\n .option('--shared-browser-context', 'reuse the same browser context between all connected HTTP clients.')\n .option('--snapshot-mode <mode>', 'when taking snapshots for responses, specifies the mode to use. Can be \"incremental\", \"full\", or \"none\". Default is incremental.')\n .option('--storage-state <path>', 'path to the storage state file for isolated sessions.')\n .option('--test-id-attribute <attribute>', 'specify the attribute to use for test ids, defaults to \"data-testid\"')\n .option('--timeout-action <timeout>', 'specify action timeout in milliseconds, defaults to 5000ms', numberParser)\n .option('--timeout-navigation <timeout>', 'specify navigation timeout in milliseconds, defaults to 60000ms', numberParser)\n .option('--user-agent <ua string>', 'specify user agent string')\n .option('--user-data-dir <path>', 'path to the user data directory. If not specified, a temporary directory will be created.')\n .option('--viewport-size <size>', 'specify browser viewport size in pixels, for example \"1280x720\"', resolutionParser.bind(null, '--viewport-size'))\n .option('--run-id <id>', 'External UUID to use for HAR directory. If not provided, a UUID will be generated.')\n .addOption(new ProgramOption('--vision', 'Legacy option, use --caps=vision instead').hideHelp())\n .action(async options => {\n setupExitWatchdog();\n\n if (options.vision) {\n console.error('The --vision option is deprecated, use --caps=vision instead');\n options.caps = 'vision';\n }\n\n const config = await resolveCLIConfig(options);\n\n // Chromium browsers require ffmpeg to be installed to save video.\n if (config.saveVideo && !checkFfmpeg()) {\n console.error(colors.red(`\\nError: ffmpeg required to save the video is not installed.`));\n console.error(`\\nPlease run the command below. It will install a local copy of ffmpeg and will not change any system-wide settings.`);\n console.error(`\\n npx playwright install ffmpeg\\n`);\n // eslint-disable-next-line no-restricted-properties\n process.exit(1);\n }\n\n const browserContextFactory = contextFactory(config);\n const extensionContextFactory = new ExtensionContextFactory(config.browser.launchOptions.channel || 'chrome', config.browser.userDataDir, config.browser.launchOptions.executablePath);\n\n if (options.extension) {\n const serverBackendFactory: mcpServer.ServerBackendFactory = {\n name: 'Playwright w/ extension',\n nameInConfig: 'playwright-extension',\n version,\n create: () => new BrowserServerBackend(config, extensionContextFactory)\n };\n await mcpServer.start(serverBackendFactory, config.server);\n return;\n }\n\n const factory: mcpServer.ServerBackendFactory = {\n name: 'Playwright',\n nameInConfig: 'playwright',\n version,\n create: () => new BrowserServerBackend(config, browserContextFactory)\n };\n await mcpServer.start(factory, config.server);\n });\n}\n\nfunction checkFfmpeg(): boolean {\n try {\n const executable = registry.findExecutable('ffmpeg')!;\n return fs.existsSync(executable.executablePath('javascript')!);\n } catch (error) {\n return false;\n }\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["fs"]
|
|
7
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __copyProps = (to, from, except, desc) => {
|
|
7
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
8
|
+
for (let key of __getOwnPropNames(from))
|
|
9
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
10
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
11
|
+
}
|
|
12
|
+
return to;
|
|
13
|
+
};
|
|
14
|
+
var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
|
|
15
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
16
|
+
var exports_exports = {};
|
|
17
|
+
module.exports = __toCommonJS(exports_exports);
|
|
18
|
+
__reExport(exports_exports, require("./inProcessTransport"), module.exports);
|
|
19
|
+
__reExport(exports_exports, require("./server"), module.exports);
|
|
20
|
+
__reExport(exports_exports, require("./tool"), module.exports);
|
|
21
|
+
__reExport(exports_exports, require("./http"), module.exports);
|
|
22
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
23
|
+
0 && (module.exports = {
|
|
24
|
+
...require("./inProcessTransport"),
|
|
25
|
+
...require("./server"),
|
|
26
|
+
...require("./tool"),
|
|
27
|
+
...require("./http")
|
|
28
|
+
});
|
|
29
|
+
//# sourceMappingURL=exports.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../../src/mcp/sdk/exports.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport * from './inProcessTransport';\nexport * from './server';\nexport * from './tool';\nexport * from './http';\n"],
|
|
5
|
+
"mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAgBA,4BAAc,iCAhBd;AAiBA,4BAAc,qBAjBd;AAkBA,4BAAc,mBAlBd;AAmBA,4BAAc,mBAnBd;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __create = Object.create;
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
5
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
6
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
7
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
8
|
+
var __export = (target, all) => {
|
|
9
|
+
for (var name in all)
|
|
10
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
11
|
+
};
|
|
12
|
+
var __copyProps = (to, from, except, desc) => {
|
|
13
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
14
|
+
for (let key of __getOwnPropNames(from))
|
|
15
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
16
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
17
|
+
}
|
|
18
|
+
return to;
|
|
19
|
+
};
|
|
20
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
21
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
22
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
23
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
24
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
25
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
26
|
+
mod
|
|
27
|
+
));
|
|
28
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
29
|
+
var http_exports = {};
|
|
30
|
+
__export(http_exports, {
|
|
31
|
+
addressToString: () => addressToString,
|
|
32
|
+
startMcpHttpServer: () => startMcpHttpServer
|
|
33
|
+
});
|
|
34
|
+
module.exports = __toCommonJS(http_exports);
|
|
35
|
+
var import_assert = __toESM(require("assert"));
|
|
36
|
+
var import_crypto = __toESM(require("crypto"));
|
|
37
|
+
var import_utilsBundle = require("playwright-core/lib/utilsBundle");
|
|
38
|
+
var mcpBundle = __toESM(require("playwright-core/lib/mcpBundle"));
|
|
39
|
+
var import_utils = require("playwright-core/lib/utils");
|
|
40
|
+
var mcpServer = __toESM(require("./server"));
|
|
41
|
+
const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
|
|
42
|
+
async function startMcpHttpServer(config, serverBackendFactory, allowedHosts) {
|
|
43
|
+
const httpServer = (0, import_utils.createHttpServer)();
|
|
44
|
+
await (0, import_utils.startHttpServer)(httpServer, config);
|
|
45
|
+
return await installHttpTransport(httpServer, serverBackendFactory, allowedHosts);
|
|
46
|
+
}
|
|
47
|
+
function addressToString(address, options) {
|
|
48
|
+
(0, import_assert.default)(address, "Could not bind server socket");
|
|
49
|
+
if (typeof address === "string")
|
|
50
|
+
throw new Error("Unexpected address type: " + address);
|
|
51
|
+
let host = address.family === "IPv4" ? address.address : `[${address.address}]`;
|
|
52
|
+
if (options.normalizeLoopback && (host === "0.0.0.0" || host === "[::]" || host === "[::1]" || host === "127.0.0.1"))
|
|
53
|
+
host = "localhost";
|
|
54
|
+
return `${options.protocol}://${host}:${address.port}`;
|
|
55
|
+
}
|
|
56
|
+
async function installHttpTransport(httpServer, serverBackendFactory, allowedHosts) {
|
|
57
|
+
const url = addressToString(httpServer.address(), { protocol: "http", normalizeLoopback: true });
|
|
58
|
+
const host = new URL(url).host;
|
|
59
|
+
allowedHosts = (allowedHosts || [host]).map((h) => h.toLowerCase());
|
|
60
|
+
const allowAnyHost = allowedHosts.includes("*");
|
|
61
|
+
const sseSessions = /* @__PURE__ */ new Map();
|
|
62
|
+
const streamableSessions = /* @__PURE__ */ new Map();
|
|
63
|
+
httpServer.on("request", async (req, res) => {
|
|
64
|
+
if (!allowAnyHost) {
|
|
65
|
+
const host2 = req.headers.host?.toLowerCase();
|
|
66
|
+
if (!host2) {
|
|
67
|
+
res.statusCode = 400;
|
|
68
|
+
return res.end("Missing host");
|
|
69
|
+
}
|
|
70
|
+
if (!allowedHosts.includes(host2)) {
|
|
71
|
+
res.statusCode = 403;
|
|
72
|
+
return res.end("Access is only allowed at " + allowedHosts.join(", "));
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
const url2 = new URL(`http://localhost${req.url}`);
|
|
76
|
+
if (url2.pathname === "/killkillkill" && req.method === "GET") {
|
|
77
|
+
res.statusCode = 200;
|
|
78
|
+
res.end("Killing process");
|
|
79
|
+
process.emit("SIGINT");
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
if (url2.pathname.startsWith("/sse"))
|
|
83
|
+
await handleSSE(serverBackendFactory, req, res, url2, sseSessions);
|
|
84
|
+
else
|
|
85
|
+
await handleStreamable(serverBackendFactory, req, res, streamableSessions);
|
|
86
|
+
});
|
|
87
|
+
return url;
|
|
88
|
+
}
|
|
89
|
+
async function handleSSE(serverBackendFactory, req, res, url, sessions) {
|
|
90
|
+
if (req.method === "POST") {
|
|
91
|
+
const sessionId = url.searchParams.get("sessionId");
|
|
92
|
+
if (!sessionId) {
|
|
93
|
+
res.statusCode = 400;
|
|
94
|
+
return res.end("Missing sessionId");
|
|
95
|
+
}
|
|
96
|
+
const transport = sessions.get(sessionId);
|
|
97
|
+
if (!transport) {
|
|
98
|
+
res.statusCode = 404;
|
|
99
|
+
return res.end("Session not found");
|
|
100
|
+
}
|
|
101
|
+
return await transport.handlePostMessage(req, res);
|
|
102
|
+
} else if (req.method === "GET") {
|
|
103
|
+
const transport = new mcpBundle.SSEServerTransport("/sse", res);
|
|
104
|
+
sessions.set(transport.sessionId, transport);
|
|
105
|
+
testDebug(`create SSE session: ${transport.sessionId}`);
|
|
106
|
+
await mcpServer.connect(serverBackendFactory, transport, false);
|
|
107
|
+
res.on("close", () => {
|
|
108
|
+
testDebug(`delete SSE session: ${transport.sessionId}`);
|
|
109
|
+
sessions.delete(transport.sessionId);
|
|
110
|
+
});
|
|
111
|
+
return;
|
|
112
|
+
}
|
|
113
|
+
res.statusCode = 405;
|
|
114
|
+
res.end("Method not allowed");
|
|
115
|
+
}
|
|
116
|
+
async function handleStreamable(serverBackendFactory, req, res, sessions) {
|
|
117
|
+
const sessionId = req.headers["mcp-session-id"];
|
|
118
|
+
if (sessionId) {
|
|
119
|
+
const transport = sessions.get(sessionId);
|
|
120
|
+
if (!transport) {
|
|
121
|
+
res.statusCode = 404;
|
|
122
|
+
res.end("Session not found");
|
|
123
|
+
return;
|
|
124
|
+
}
|
|
125
|
+
return await transport.handleRequest(req, res);
|
|
126
|
+
}
|
|
127
|
+
if (req.method === "POST") {
|
|
128
|
+
const transport = new mcpBundle.StreamableHTTPServerTransport({
|
|
129
|
+
sessionIdGenerator: () => import_crypto.default.randomUUID(),
|
|
130
|
+
onsessioninitialized: async (sessionId2) => {
|
|
131
|
+
testDebug(`create http session: ${transport.sessionId}`);
|
|
132
|
+
await mcpServer.connect(serverBackendFactory, transport, true);
|
|
133
|
+
sessions.set(sessionId2, transport);
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
transport.onclose = () => {
|
|
137
|
+
if (!transport.sessionId)
|
|
138
|
+
return;
|
|
139
|
+
sessions.delete(transport.sessionId);
|
|
140
|
+
testDebug(`delete http session: ${transport.sessionId}`);
|
|
141
|
+
};
|
|
142
|
+
await transport.handleRequest(req, res);
|
|
143
|
+
return;
|
|
144
|
+
}
|
|
145
|
+
res.statusCode = 400;
|
|
146
|
+
res.end("Invalid request");
|
|
147
|
+
}
|
|
148
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
149
|
+
0 && (module.exports = {
|
|
150
|
+
addressToString,
|
|
151
|
+
startMcpHttpServer
|
|
152
|
+
});
|
|
153
|
+
//# sourceMappingURL=http.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../../src/mcp/sdk/http.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport assert from 'assert';\nimport net from 'net';\nimport http from 'http';\nimport crypto from 'crypto';\n\nimport { debug } from 'playwright-core/lib/utilsBundle';\nimport * as mcpBundle from 'playwright-core/lib/mcpBundle';\nimport { createHttpServer, startHttpServer } from 'playwright-core/lib/utils';\n\nimport * as mcpServer from './server';\n\nimport type { ServerBackendFactory } from './server';\nimport type { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';\nimport type { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';\n\nconst testDebug = debug('pw:mcp:test');\n\nexport async function startMcpHttpServer(\n config: { host?: string, port?: number },\n serverBackendFactory: ServerBackendFactory,\n allowedHosts?: string[]\n): Promise<string> {\n const httpServer = createHttpServer();\n await startHttpServer(httpServer, config);\n return await installHttpTransport(httpServer, serverBackendFactory, allowedHosts);\n}\n\nexport function addressToString(address: string | net.AddressInfo | null, options: {\n protocol: 'http' | 'ws';\n normalizeLoopback?: boolean;\n}): string {\n assert(address, 'Could not bind server socket');\n if (typeof address === 'string')\n throw new Error('Unexpected address type: ' + address);\n let host = address.family === 'IPv4' ? address.address : `[${address.address}]`;\n if (options.normalizeLoopback && (host === '0.0.0.0' || host === '[::]' || host === '[::1]' || host === '127.0.0.1'))\n host = 'localhost';\n return `${options.protocol}://${host}:${address.port}`;\n}\n\nasync function installHttpTransport(httpServer: http.Server, serverBackendFactory: ServerBackendFactory, allowedHosts?: string[]) {\n const url = addressToString(httpServer.address(), { protocol: 'http', normalizeLoopback: true });\n const host = new URL(url).host;\n allowedHosts = (allowedHosts || [host]).map(h => h.toLowerCase());\n const allowAnyHost = allowedHosts.includes('*');\n\n const sseSessions = new Map();\n const streamableSessions = new Map();\n httpServer.on('request', async (req, res) => {\n if (!allowAnyHost) {\n const host = req.headers.host?.toLowerCase();\n if (!host) {\n res.statusCode = 400;\n return res.end('Missing host');\n }\n\n // Prevent DNS evil.com -> localhost rebind.\n if (!allowedHosts.includes(host)) {\n // Access from the browser is forbidden.\n res.statusCode = 403;\n return res.end('Access is only allowed at ' + allowedHosts.join(', '));\n }\n }\n\n const url = new URL(`http://localhost${req.url}`);\n if (url.pathname === '/killkillkill' && req.method === 'GET') {\n res.statusCode = 200;\n res.end('Killing process');\n // Simulate Ctrl+C in a way that works on Windows too.\n process.emit('SIGINT');\n return;\n }\n if (url.pathname.startsWith('/sse'))\n await handleSSE(serverBackendFactory, req, res, url, sseSessions);\n else\n await handleStreamable(serverBackendFactory, req, res, streamableSessions);\n });\n\n return url;\n}\n\nasync function handleSSE(serverBackendFactory: ServerBackendFactory, req: http.IncomingMessage, res: http.ServerResponse, url: URL, sessions: Map<string, SSEServerTransport>) {\n if (req.method === 'POST') {\n const sessionId = url.searchParams.get('sessionId');\n if (!sessionId) {\n res.statusCode = 400;\n return res.end('Missing sessionId');\n }\n\n const transport = sessions.get(sessionId);\n if (!transport) {\n res.statusCode = 404;\n return res.end('Session not found');\n }\n\n return await transport.handlePostMessage(req, res);\n } else if (req.method === 'GET') {\n const transport = new mcpBundle.SSEServerTransport('/sse', res);\n sessions.set(transport.sessionId, transport);\n testDebug(`create SSE session: ${transport.sessionId}`);\n await mcpServer.connect(serverBackendFactory, transport, false);\n res.on('close', () => {\n testDebug(`delete SSE session: ${transport.sessionId}`);\n sessions.delete(transport.sessionId);\n });\n return;\n }\n\n res.statusCode = 405;\n res.end('Method not allowed');\n}\n\nasync function handleStreamable(serverBackendFactory: ServerBackendFactory, req: http.IncomingMessage, res: http.ServerResponse, sessions: Map<string, StreamableHTTPServerTransport>) {\n const sessionId = req.headers['mcp-session-id'] as string | undefined;\n if (sessionId) {\n const transport = sessions.get(sessionId);\n if (!transport) {\n res.statusCode = 404;\n res.end('Session not found');\n return;\n }\n return await transport.handleRequest(req, res);\n }\n\n if (req.method === 'POST') {\n const transport = new mcpBundle.StreamableHTTPServerTransport({\n sessionIdGenerator: () => crypto.randomUUID(),\n onsessioninitialized: async sessionId => {\n testDebug(`create http session: ${transport.sessionId}`);\n await mcpServer.connect(serverBackendFactory, transport, true);\n sessions.set(sessionId, transport);\n }\n });\n\n transport.onclose = () => {\n if (!transport.sessionId)\n return;\n sessions.delete(transport.sessionId);\n testDebug(`delete http session: ${transport.sessionId}`);\n };\n\n await transport.handleRequest(req, res);\n return;\n }\n\n res.statusCode = 400;\n res.end('Invalid request');\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["assert", "host", "url", "crypto", "sessionId"]
|
|
7
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
var inProcessTransport_exports = {};
|
|
20
|
+
__export(inProcessTransport_exports, {
|
|
21
|
+
InProcessTransport: () => InProcessTransport
|
|
22
|
+
});
|
|
23
|
+
module.exports = __toCommonJS(inProcessTransport_exports);
|
|
24
|
+
class InProcessTransport {
|
|
25
|
+
constructor(server) {
|
|
26
|
+
this._connected = false;
|
|
27
|
+
this._server = server;
|
|
28
|
+
this._serverTransport = new InProcessServerTransport(this);
|
|
29
|
+
}
|
|
30
|
+
async start() {
|
|
31
|
+
if (this._connected)
|
|
32
|
+
throw new Error("InprocessTransport already started!");
|
|
33
|
+
await this._server.connect(this._serverTransport);
|
|
34
|
+
this._connected = true;
|
|
35
|
+
}
|
|
36
|
+
async send(message, options) {
|
|
37
|
+
if (!this._connected)
|
|
38
|
+
throw new Error("Transport not connected");
|
|
39
|
+
this._serverTransport._receiveFromClient(message);
|
|
40
|
+
}
|
|
41
|
+
async close() {
|
|
42
|
+
if (this._connected) {
|
|
43
|
+
this._connected = false;
|
|
44
|
+
this.onclose?.();
|
|
45
|
+
this._serverTransport.onclose?.();
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
_receiveFromServer(message, extra) {
|
|
49
|
+
this.onmessage?.(message, extra);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
class InProcessServerTransport {
|
|
53
|
+
constructor(clientTransport) {
|
|
54
|
+
this._clientTransport = clientTransport;
|
|
55
|
+
}
|
|
56
|
+
async start() {
|
|
57
|
+
}
|
|
58
|
+
async send(message, options) {
|
|
59
|
+
this._clientTransport._receiveFromServer(message);
|
|
60
|
+
}
|
|
61
|
+
async close() {
|
|
62
|
+
this.onclose?.();
|
|
63
|
+
}
|
|
64
|
+
_receiveFromClient(message) {
|
|
65
|
+
this.onmessage?.(message);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
69
|
+
0 && (module.exports = {
|
|
70
|
+
InProcessTransport
|
|
71
|
+
});
|
|
72
|
+
//# sourceMappingURL=inProcessTransport.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../../src/mcp/sdk/inProcessTransport.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';\nimport type { JSONRPCMessage, MessageExtraInfo } from '@modelcontextprotocol/sdk/types.js';\n\nexport class InProcessTransport implements Transport {\n private _server: Server;\n private _serverTransport: InProcessServerTransport;\n private _connected: boolean = false;\n\n constructor(server: Server) {\n this._server = server;\n this._serverTransport = new InProcessServerTransport(this);\n }\n\n async start(): Promise<void> {\n if (this._connected)\n throw new Error('InprocessTransport already started!');\n\n await this._server.connect(this._serverTransport);\n this._connected = true;\n }\n\n async send(message: JSONRPCMessage, options?: TransportSendOptions): Promise<void> {\n if (!this._connected)\n throw new Error('Transport not connected');\n\n\n this._serverTransport._receiveFromClient(message);\n }\n\n async close(): Promise<void> {\n if (this._connected) {\n this._connected = false;\n this.onclose?.();\n this._serverTransport.onclose?.();\n }\n }\n\n onclose?: (() => void) | undefined;\n onerror?: ((error: Error) => void) | undefined;\n onmessage?: ((message: JSONRPCMessage, extra?: MessageExtraInfo) => void) | undefined;\n sessionId?: string | undefined;\n setProtocolVersion?: ((version: string) => void) | undefined;\n\n _receiveFromServer(message: JSONRPCMessage, extra?: MessageExtraInfo): void {\n this.onmessage?.(message, extra);\n }\n}\n\nclass InProcessServerTransport implements Transport {\n private _clientTransport: InProcessTransport;\n\n constructor(clientTransport: InProcessTransport) {\n this._clientTransport = clientTransport;\n }\n\n async start(): Promise<void> {\n }\n\n async send(message: JSONRPCMessage, options?: TransportSendOptions): Promise<void> {\n this._clientTransport._receiveFromServer(message);\n }\n\n async close(): Promise<void> {\n this.onclose?.();\n }\n\n onclose?: (() => void) | undefined;\n onerror?: ((error: Error) => void) | undefined;\n onmessage?: ((message: JSONRPCMessage, extra?: MessageExtraInfo) => void) | undefined;\n sessionId?: string | undefined;\n setProtocolVersion?: ((version: string) => void) | undefined;\n _receiveFromClient(message: JSONRPCMessage): void {\n this.onmessage?.(message);\n }\n}\n"],
|
|
5
|
+
"mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBO,MAAM,mBAAwC;AAAA,EAKnD,YAAY,QAAgB;AAF5B,SAAQ,aAAsB;AAG5B,SAAK,UAAU;AACf,SAAK,mBAAmB,IAAI,yBAAyB,IAAI;AAAA,EAC3D;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK;AACP,YAAM,IAAI,MAAM,qCAAqC;AAEvD,UAAM,KAAK,QAAQ,QAAQ,KAAK,gBAAgB;AAChD,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,KAAK,SAAyB,SAA+C;AACjF,QAAI,CAAC,KAAK;AACR,YAAM,IAAI,MAAM,yBAAyB;AAG3C,SAAK,iBAAiB,mBAAmB,OAAO;AAAA,EAClD;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,YAAY;AACnB,WAAK,aAAa;AAClB,WAAK,UAAU;AACf,WAAK,iBAAiB,UAAU;AAAA,IAClC;AAAA,EACF;AAAA,EAQA,mBAAmB,SAAyB,OAAgC;AAC1E,SAAK,YAAY,SAAS,KAAK;AAAA,EACjC;AACF;AAEA,MAAM,yBAA8C;AAAA,EAGlD,YAAY,iBAAqC;AAC/C,SAAK,mBAAmB;AAAA,EAC1B;AAAA,EAEA,MAAM,QAAuB;AAAA,EAC7B;AAAA,EAEA,MAAM,KAAK,SAAyB,SAA+C;AACjF,SAAK,iBAAiB,mBAAmB,OAAO;AAAA,EAClD;AAAA,EAEA,MAAM,QAAuB;AAC3B,SAAK,UAAU;AAAA,EACjB;AAAA,EAOA,mBAAmB,SAA+B;AAChD,SAAK,YAAY,OAAO;AAAA,EAC1B;AACF;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|