@wp-playground/mcp 3.1.5 → 3.1.8

package/mcp-server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(port: number): McpServer;

package/package.json

@@ -1,46 +1,80 @@
 {
-	"name": "@wp-playground/mcp",
-	"version": "3.1.5",
-	"description": "MCP server for WordPress Playground - enables AI agents to interact with the WordPress Playground website.",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/WordPress/wordpress-playground"
-	},
-	"homepage": "https://developer.wordpress.org/playground",
-	"author": "The WordPress contributors",
-	"license": "GPL-2.0-or-later",
-	"type": "module",
-	"bin": {
-		"wp-playground-mcp": "./index.js"
-	},
-	"exports": {
-		".": {
-			"import": "./src/index.ts",
-			"require": "./index.cjs"
-		},
-		"./client": {
-			"import": "./src/client.ts",
-			"require": "./client.cjs"
-		},
-		"./package.json": "./package.json"
-	},
-	"publishConfig": {
-		"access": "public",
-		"directory": "../../../dist/packages/playground/mcp"
-	},
-	"main": "./index.cjs",
-	"module": "./index.js",
-	"types": "index.d.ts",
-	"engines": {
-		"node": ">=20.10.0",
-		"npm": ">=10.2.3"
-	},
-	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.27.0",
-		"ws": "^8.18.0",
-		"zod": "^4.3"
-	},
-	"devDependencies": {
-		"@types/ws": "^8.18.0"
-	}
-}
+  "name": "@wp-playground/mcp",
+  "version": "3.1.8",
+  "description": "MCP server for WordPress Playground - enables AI agents to interact with the WordPress Playground website.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WordPress/wordpress-playground"
+  },
+  "homepage": "https://developer.wordpress.org/playground",
+  "author": "The WordPress contributors",
+  "license": "GPL-2.0-or-later",
+  "type": "module",
+  "bin": {
+    "wp-playground-mcp": "./index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs"
+    },
+    "./client": {
+      "import": "./client.js",
+      "require": "./client.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "directory": "../../../dist/packages/playground/mcp"
+  },
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "index.d.ts",
+  "engines": {
+    "node": ">=20.10.0",
+    "npm": ">=10.2.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@types/ws": "8.18.1",
+    "@zip.js/zip.js": "2.7.57",
+    "ajv": "8.12.0",
+    "async-lock": "1.4.1",
+    "clean-git-ref": "2.0.1",
+    "crc-32": "1.2.2",
+    "diff3": "0.0.4",
+    "express": "4.22.0",
+    "fast-xml-parser": "^5.5.1",
+    "fs-ext-extra-prebuilt": "2.2.7",
+    "ignore": "5.3.2",
+    "ini": "4.1.2",
+    "jsonc-parser": "3.3.1",
+    "minimisted": "2.0.1",
+    "octokit": "3.1.2",
+    "pako": "1.0.10",
+    "pify": "2.3.0",
+    "readable-stream": "3.6.2",
+    "sha.js": "2.4.12",
+    "simple-get": "4.0.1",
+    "wasm-feature-detect": "1.8.0",
+    "ws": "^8.18.0",
+    "yargs": "17.7.2",
+    "zod": "^4.3",
+    "@wp-playground/remote": "3.1.8",
+    "@php-wasm/universal": "3.1.8"
+  },
+  "gitHead": "ba6a9509c9db4e0b7af6f155cf31162a6b659b5f",
+  "packageManager": "npm@10.9.2",
+  "overrides": {
+    "rollup": "^4.34.6",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.4.5",
+    "@playwright/test": "1.55.1",
+    "tmp": "0.2.5",
+    "form-data": "^4.0.4",
+    "lodash": "^4.17.23",
+    "glob": "^9.3.0"
+  }
+}

package/tool-executors-ecXfLzk7.cjs

@@ -0,0 +1,9 @@
+"use strict";async function u(r){const[e,s]=await Promise.all([r.getCurrentURL(),r.run({code:`<?php
+			require_once "/wordpress/wp-load.php";
+			echo json_encode([
+				"documentRoot" => ABSPATH,
+				"wpVersion" => get_bloginfo("version"),
+				"siteUrl" => get_site_url(),
+				"phpVersion" => phpversion(),
+			]);`}).then(o=>o.text)]);let t;try{t=JSON.parse(s)}catch{t={}}return{url:String(e),documentRoot:t.documentRoot??"/wordpress",siteUrl:t.siteUrl??String(e),wpVersion:t.wpVersion??"unknown",phpVersion:t.phpVersion??"unknown"}}const i={playground_execute_php:(r,e)=>r.run({code:e.code}),playground_request:async(r,e)=>{const s={url:e.url,method:e.method??"GET"};return e.headers&&(s.headers=e.headers),e.body&&(s.body=e.body),await r.request(s)},playground_navigate:async(r,e)=>(await r.goTo(e.path),{url:await r.getCurrentURL()}),playground_get_current_url:async r=>({url:await r.getCurrentURL()}),playground_get_site_info:r=>u(r),playground_read_file:async(r,e)=>({contents:await r.readFileAsText(e.path)}),playground_write_file:async(r,e)=>(await r.writeFile(e.path,e.contents),{success:!0}),playground_list_files:async(r,e)=>({files:await r.listFiles(e.path)}),playground_mkdir:async(r,e)=>(await r.mkdirTree(e.path),{success:!0}),playground_delete_file:async(r,e)=>(await r.unlink(e.path),{success:!0}),playground_delete_directory:async(r,e)=>(await r.rmdir(e.path,{recursive:e.recursive??!1}),{success:!0}),playground_file_exists:async(r,e)=>({exists:await r.fileExists(e.path)})};function d(r){const e=new TextDecoder,s={async run(t){const o=await r.run(t);return{text:e.decode(o.bytes),errors:o.errors,exitCode:o.exitCode}},async request(t){const o=await r.request({url:t.url,method:t.method,headers:t.headers,body:t.body});return{text:e.decode(o.bytes),httpStatusCode:o.httpStatusCode,headers:o.headers}}};return new Proxy(r,{get:(t,o)=>{const a=s[o];if(a!==void 0)return a;const n=t[o];return typeof n=="function"?n.bind(t):n}})}exports.createToolClient=d;exports.toolExecutors=i;
+//# sourceMappingURL=tool-executors-ecXfLzk7.cjs.map

package/tool-executors-ecXfLzk7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executors-ecXfLzk7.cjs","sources":["../../../../packages/playground/mcp/src/tools/tool-executors.ts"],"sourcesContent":["/**\n * Shared tool executor functions.\n *\n * Both the MCP server and WebMCP call these executors so that tool\n * output shapes are defined in exactly one place.  Each transport\n * provides its own ToolClient implementation that normalises I/O\n * differences (e.g. byte decoding).\n */\n\nimport type { PlaygroundClient } from '@wp-playground/remote';\nimport type { PHPRequest } from '@php-wasm/universal';\n\n/**\n * Minimal client interface consumed by tool executors.\n *\n * - WebMCP implements this by wrapping PlaygroundClient (decoding\n *   response bytes via TextDecoder).\n * - The MCP server implements this by wrapping bridge.sendCommand\n *   (bytes are already decoded at the bridge-client boundary).\n */\nexport interface ToolClient {\n\trun(options: {\n\t\tcode: string;\n\t}): Promise<{ text: string; errors: string; exitCode: number }>;\n\trequest(options: {\n\t\turl: string;\n\t\tmethod: string;\n\t\theaders?: Record<string, string>;\n\t\tbody?: string;\n\t}): Promise<{\n\t\ttext: string;\n\t\thttpStatusCode: number;\n\t\theaders: Record<string, string[]>;\n\t}>;\n\tgoTo(path: string): Promise<void>;\n\tgetCurrentURL(): Promise<string>;\n\treadFileAsText(path: string): Promise<string>;\n\twriteFile(path: string, contents: string): Promise<void>;\n\tlistFiles(path: string): Promise<string[]>;\n\tmkdirTree(path: string): Promise<void>;\n\tunlink(path: string): Promise<void>;\n\trmdir(path: string, options: { recursive: boolean }): Promise<void>;\n\tfileExists(path: string): Promise<boolean>;\n}\n\nexport interface SiteInfo {\n\turl: string;\n\tdocumentRoot: string;\n\tsiteUrl: string;\n\twpVersion: string;\n\tphpVersion: string;\n}\n\nasync function executeSiteInfo(client: ToolClient): Promise<SiteInfo> {\n\tconst [url, infoText] = await Promise.all([\n\t\tclient.getCurrentURL(),\n\t\tclient\n\t\t\t.run({\n\t\t\t\tcode: `<?php\n\t\t\trequire_once \"/wordpress/wp-load.php\";\n\t\t\techo json_encode([\n\t\t\t\t\"documentRoot\" => ABSPATH,\n\t\t\t\t\"wpVersion\" => get_bloginfo(\"version\"),\n\t\t\t\t\"siteUrl\" => get_site_url(),\n\t\t\t\t\"phpVersion\" => phpversion(),\n\t\t\t]);`,\n\t\t\t})\n\t\t\t.then((resp) => resp.text),\n\t]);\n\n\tlet info: Partial<Omit<SiteInfo, 'url'>>;\n\ttry {\n\t\tinfo = JSON.parse(infoText);\n\t} catch {\n\t\tinfo = {};\n\t}\n\n\treturn {\n\t\turl: String(url),\n\t\tdocumentRoot: info.documentRoot ?? '/wordpress',\n\t\tsiteUrl: info.siteUrl ?? String(url),\n\t\twpVersion: info.wpVersion ?? 'unknown',\n\t\tphpVersion: info.phpVersion ?? 'unknown',\n\t};\n}\n\nexport const toolExecutors: Record<\n\tstring,\n\t(client: ToolClient, input: Record<string, unknown>) => Promise<unknown>\n> = {\n\tplayground_execute_php: (client, input) =>\n\t\tclient.run({ code: input['code'] as string }),\n\n\tplayground_request: async (client, input) => {\n\t\tconst options: {\n\t\t\turl: string;\n\t\t\tmethod: string;\n\t\t\theaders?: Record<string, string>;\n\t\t\tbody?: string;\n\t\t} = {\n\t\t\turl: input['url'] as string,\n\t\t\tmethod: (input['method'] as string) ?? 'GET',\n\t\t};\n\t\tif (input['headers']) {\n\t\t\toptions.headers = input['headers'] as Record<string, string>;\n\t\t}\n\t\tif (input['body']) {\n\t\t\toptions.body = input['body'] as string;\n\t\t}\n\t\treturn await client.request(options);\n\t},\n\n\tplayground_navigate: async (client, input) => {\n\t\tawait client.goTo(input['path'] as string);\n\t\treturn { url: await client.getCurrentURL() };\n\t},\n\n\tplayground_get_current_url: async (client) => ({\n\t\turl: await client.getCurrentURL(),\n\t}),\n\n\tplayground_get_site_info: (client): Promise<SiteInfo> =>\n\t\texecuteSiteInfo(client),\n\n\tplayground_read_file: async (client, input) => ({\n\t\tcontents: await client.readFileAsText(input['path'] as string),\n\t}),\n\n\tplayground_write_file: async (client, input) => {\n\t\tawait client.writeFile(\n\t\t\tinput['path'] as string,\n\t\t\tinput['contents'] as string\n\t\t);\n\t\treturn { success: true };\n\t},\n\n\tplayground_list_files: async (client, input) => ({\n\t\tfiles: await client.listFiles(input['path'] as string),\n\t}),\n\n\tplayground_mkdir: async (client, input) => {\n\t\tawait client.mkdirTree(input['path'] as string);\n\t\treturn { success: true };\n\t},\n\n\tplayground_delete_file: async (client, input) => {\n\t\tawait client.unlink(input['path'] as string);\n\t\treturn { success: true };\n\t},\n\n\tplayground_delete_directory: async (client, input) => {\n\t\tawait client.rmdir(input['path'] as string, {\n\t\t\trecursive: (input['recursive'] as boolean) ?? false,\n\t\t});\n\t\treturn { success: true };\n\t},\n\n\tplayground_file_exists: async (client, input) => ({\n\t\texists: await client.fileExists(input['path'] as string),\n\t}),\n};\n\n/**\n * Wrap a PlaygroundClient as a ToolClient.\n *\n * Most methods pass through directly. Only `run` and `request`\n * are intercepted to decode PHP/HTTP response bytes into plain\n * strings via TextDecoder.\n */\nexport function createToolClient(client: PlaygroundClient): ToolClient {\n\tconst decoder = new TextDecoder();\n\tconst overrides: Partial<ToolClient> = {\n\t\tasync run(options) {\n\t\t\tconst resp = await client.run(options);\n\t\t\treturn {\n\t\t\t\ttext: decoder.decode(resp.bytes),\n\t\t\t\terrors: resp.errors,\n\t\t\t\texitCode: resp.exitCode,\n\t\t\t};\n\t\t},\n\t\tasync request(options) {\n\t\t\tconst resp = await client.request({\n\t\t\t\turl: options.url,\n\t\t\t\tmethod: options.method as PHPRequest['method'],\n\t\t\t\theaders: options.headers,\n\t\t\t\tbody: options.body,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\ttext: decoder.decode(resp.bytes),\n\t\t\t\thttpStatusCode: resp.httpStatusCode,\n\t\t\t\theaders: resp.headers,\n\t\t\t};\n\t\t},\n\t};\n\treturn new Proxy(client as unknown as ToolClient, {\n\t\tget: (target, prop: string) => {\n\t\t\tconst override = (overrides as Record<string, unknown>)[prop];\n\t\t\tif (override !== undefined) {\n\t\t\t\treturn override;\n\t\t\t}\n\t\t\tconst val = (target as unknown as Record<string, unknown>)[prop];\n\t\t\treturn typeof val === 'function' ? val.bind(target) : val;\n\t\t},\n\t});\n}\n"],"names":["executeSiteInfo","client","url","infoText","resp","info","toolExecutors","input","options","createToolClient","decoder","overrides","target","prop","override","val"],"mappings":"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"}

package/tool-executors-pMxJ1GXT.js

@@ -0,0 +1,100 @@
+async function u(r) {
+  const [e, o] = await Promise.all([
+    r.getCurrentURL(),
+    r.run({
+      code: `<?php
+			require_once "/wordpress/wp-load.php";
+			echo json_encode([
+				"documentRoot" => ABSPATH,
+				"wpVersion" => get_bloginfo("version"),
+				"siteUrl" => get_site_url(),
+				"phpVersion" => phpversion(),
+			]);`
+    }).then((s) => s.text)
+  ]);
+  let t;
+  try {
+    t = JSON.parse(o);
+  } catch {
+    t = {};
+  }
+  return {
+    url: String(e),
+    documentRoot: t.documentRoot ?? "/wordpress",
+    siteUrl: t.siteUrl ?? String(e),
+    wpVersion: t.wpVersion ?? "unknown",
+    phpVersion: t.phpVersion ?? "unknown"
+  };
+}
+const d = {
+  playground_execute_php: (r, e) => r.run({ code: e.code }),
+  playground_request: async (r, e) => {
+    const o = {
+      url: e.url,
+      method: e.method ?? "GET"
+    };
+    return e.headers && (o.headers = e.headers), e.body && (o.body = e.body), await r.request(o);
+  },
+  playground_navigate: async (r, e) => (await r.goTo(e.path), { url: await r.getCurrentURL() }),
+  playground_get_current_url: async (r) => ({
+    url: await r.getCurrentURL()
+  }),
+  playground_get_site_info: (r) => u(r),
+  playground_read_file: async (r, e) => ({
+    contents: await r.readFileAsText(e.path)
+  }),
+  playground_write_file: async (r, e) => (await r.writeFile(
+    e.path,
+    e.contents
+  ), { success: !0 }),
+  playground_list_files: async (r, e) => ({
+    files: await r.listFiles(e.path)
+  }),
+  playground_mkdir: async (r, e) => (await r.mkdirTree(e.path), { success: !0 }),
+  playground_delete_file: async (r, e) => (await r.unlink(e.path), { success: !0 }),
+  playground_delete_directory: async (r, e) => (await r.rmdir(e.path, {
+    recursive: e.recursive ?? !1
+  }), { success: !0 }),
+  playground_file_exists: async (r, e) => ({
+    exists: await r.fileExists(e.path)
+  })
+};
+function i(r) {
+  const e = new TextDecoder(), o = {
+    async run(t) {
+      const s = await r.run(t);
+      return {
+        text: e.decode(s.bytes),
+        errors: s.errors,
+        exitCode: s.exitCode
+      };
+    },
+    async request(t) {
+      const s = await r.request({
+        url: t.url,
+        method: t.method,
+        headers: t.headers,
+        body: t.body
+      });
+      return {
+        text: e.decode(s.bytes),
+        httpStatusCode: s.httpStatusCode,
+        headers: s.headers
+      };
+    }
+  };
+  return new Proxy(r, {
+    get: (t, s) => {
+      const a = o[s];
+      if (a !== void 0)
+        return a;
+      const n = t[s];
+      return typeof n == "function" ? n.bind(t) : n;
+    }
+  });
+}
+export {
+  i as c,
+  d as t
+};
+//# sourceMappingURL=tool-executors-pMxJ1GXT.js.map

package/tool-executors-pMxJ1GXT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executors-pMxJ1GXT.js","sources":["../../../../packages/playground/mcp/src/tools/tool-executors.ts"],"sourcesContent":["/**\n * Shared tool executor functions.\n *\n * Both the MCP server and WebMCP call these executors so that tool\n * output shapes are defined in exactly one place.  Each transport\n * provides its own ToolClient implementation that normalises I/O\n * differences (e.g. byte decoding).\n */\n\nimport type { PlaygroundClient } from '@wp-playground/remote';\nimport type { PHPRequest } from '@php-wasm/universal';\n\n/**\n * Minimal client interface consumed by tool executors.\n *\n * - WebMCP implements this by wrapping PlaygroundClient (decoding\n *   response bytes via TextDecoder).\n * - The MCP server implements this by wrapping bridge.sendCommand\n *   (bytes are already decoded at the bridge-client boundary).\n */\nexport interface ToolClient {\n\trun(options: {\n\t\tcode: string;\n\t}): Promise<{ text: string; errors: string; exitCode: number }>;\n\trequest(options: {\n\t\turl: string;\n\t\tmethod: string;\n\t\theaders?: Record<string, string>;\n\t\tbody?: string;\n\t}): Promise<{\n\t\ttext: string;\n\t\thttpStatusCode: number;\n\t\theaders: Record<string, string[]>;\n\t}>;\n\tgoTo(path: string): Promise<void>;\n\tgetCurrentURL(): Promise<string>;\n\treadFileAsText(path: string): Promise<string>;\n\twriteFile(path: string, contents: string): Promise<void>;\n\tlistFiles(path: string): Promise<string[]>;\n\tmkdirTree(path: string): Promise<void>;\n\tunlink(path: string): Promise<void>;\n\trmdir(path: string, options: { recursive: boolean }): Promise<void>;\n\tfileExists(path: string): Promise<boolean>;\n}\n\nexport interface SiteInfo {\n\turl: string;\n\tdocumentRoot: string;\n\tsiteUrl: string;\n\twpVersion: string;\n\tphpVersion: string;\n}\n\nasync function executeSiteInfo(client: ToolClient): Promise<SiteInfo> {\n\tconst [url, infoText] = await Promise.all([\n\t\tclient.getCurrentURL(),\n\t\tclient\n\t\t\t.run({\n\t\t\t\tcode: `<?php\n\t\t\trequire_once \"/wordpress/wp-load.php\";\n\t\t\techo json_encode([\n\t\t\t\t\"documentRoot\" => ABSPATH,\n\t\t\t\t\"wpVersion\" => get_bloginfo(\"version\"),\n\t\t\t\t\"siteUrl\" => get_site_url(),\n\t\t\t\t\"phpVersion\" => phpversion(),\n\t\t\t]);`,\n\t\t\t})\n\t\t\t.then((resp) => resp.text),\n\t]);\n\n\tlet info: Partial<Omit<SiteInfo, 'url'>>;\n\ttry {\n\t\tinfo = JSON.parse(infoText);\n\t} catch {\n\t\tinfo = {};\n\t}\n\n\treturn {\n\t\turl: String(url),\n\t\tdocumentRoot: info.documentRoot ?? '/wordpress',\n\t\tsiteUrl: info.siteUrl ?? String(url),\n\t\twpVersion: info.wpVersion ?? 'unknown',\n\t\tphpVersion: info.phpVersion ?? 'unknown',\n\t};\n}\n\nexport const toolExecutors: Record<\n\tstring,\n\t(client: ToolClient, input: Record<string, unknown>) => Promise<unknown>\n> = {\n\tplayground_execute_php: (client, input) =>\n\t\tclient.run({ code: input['code'] as string }),\n\n\tplayground_request: async (client, input) => {\n\t\tconst options: {\n\t\t\turl: string;\n\t\t\tmethod: string;\n\t\t\theaders?: Record<string, string>;\n\t\t\tbody?: string;\n\t\t} = {\n\t\t\turl: input['url'] as string,\n\t\t\tmethod: (input['method'] as string) ?? 'GET',\n\t\t};\n\t\tif (input['headers']) {\n\t\t\toptions.headers = input['headers'] as Record<string, string>;\n\t\t}\n\t\tif (input['body']) {\n\t\t\toptions.body = input['body'] as string;\n\t\t}\n\t\treturn await client.request(options);\n\t},\n\n\tplayground_navigate: async (client, input) => {\n\t\tawait client.goTo(input['path'] as string);\n\t\treturn { url: await client.getCurrentURL() };\n\t},\n\n\tplayground_get_current_url: async (client) => ({\n\t\turl: await client.getCurrentURL(),\n\t}),\n\n\tplayground_get_site_info: (client): Promise<SiteInfo> =>\n\t\texecuteSiteInfo(client),\n\n\tplayground_read_file: async (client, input) => ({\n\t\tcontents: await client.readFileAsText(input['path'] as string),\n\t}),\n\n\tplayground_write_file: async (client, input) => {\n\t\tawait client.writeFile(\n\t\t\tinput['path'] as string,\n\t\t\tinput['contents'] as string\n\t\t);\n\t\treturn { success: true };\n\t},\n\n\tplayground_list_files: async (client, input) => ({\n\t\tfiles: await client.listFiles(input['path'] as string),\n\t}),\n\n\tplayground_mkdir: async (client, input) => {\n\t\tawait client.mkdirTree(input['path'] as string);\n\t\treturn { success: true };\n\t},\n\n\tplayground_delete_file: async (client, input) => {\n\t\tawait client.unlink(input['path'] as string);\n\t\treturn { success: true };\n\t},\n\n\tplayground_delete_directory: async (client, input) => {\n\t\tawait client.rmdir(input['path'] as string, {\n\t\t\trecursive: (input['recursive'] as boolean) ?? false,\n\t\t});\n\t\treturn { success: true };\n\t},\n\n\tplayground_file_exists: async (client, input) => ({\n\t\texists: await client.fileExists(input['path'] as string),\n\t}),\n};\n\n/**\n * Wrap a PlaygroundClient as a ToolClient.\n *\n * Most methods pass through directly. Only `run` and `request`\n * are intercepted to decode PHP/HTTP response bytes into plain\n * strings via TextDecoder.\n */\nexport function createToolClient(client: PlaygroundClient): ToolClient {\n\tconst decoder = new TextDecoder();\n\tconst overrides: Partial<ToolClient> = {\n\t\tasync run(options) {\n\t\t\tconst resp = await client.run(options);\n\t\t\treturn {\n\t\t\t\ttext: decoder.decode(resp.bytes),\n\t\t\t\terrors: resp.errors,\n\t\t\t\texitCode: resp.exitCode,\n\t\t\t};\n\t\t},\n\t\tasync request(options) {\n\t\t\tconst resp = await client.request({\n\t\t\t\turl: options.url,\n\t\t\t\tmethod: options.method as PHPRequest['method'],\n\t\t\t\theaders: options.headers,\n\t\t\t\tbody: options.body,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\ttext: decoder.decode(resp.bytes),\n\t\t\t\thttpStatusCode: resp.httpStatusCode,\n\t\t\t\theaders: resp.headers,\n\t\t\t};\n\t\t},\n\t};\n\treturn new Proxy(client as unknown as ToolClient, {\n\t\tget: (target, prop: string) => {\n\t\t\tconst override = (overrides as Record<string, unknown>)[prop];\n\t\t\tif (override !== undefined) {\n\t\t\t\treturn override;\n\t\t\t}\n\t\t\tconst val = (target as unknown as Record<string, unknown>)[prop];\n\t\t\treturn typeof val === 'function' ? val.bind(target) : val;\n\t\t},\n\t});\n}\n"],"names":["executeSiteInfo","client","url","infoText","resp","info","toolExecutors","input","options","createToolClient","decoder","overrides","target","prop","override","val"],"mappings":"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"}

package/tools/register-mcp-server-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { PlaygroundBridge } from '../bridge-server';
+export declare function registerMcpServerTools(server: McpServer, bridge: PlaygroundBridge, port: number): void;

package/tools/tool-definitions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tool metadata and schema helpers for WordPress Playground.
+ *
+ * Pure data — no execution logic. Both the MCP server and
+ * WebMCP import these for consistent descriptions, annotations,
+ * and schema conversion.
+ */
+export interface ToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export type ToolParamType = 'string' | 'boolean' | 'object';
+export interface ToolParam {
+    name: string;
+    type: ToolParamType;
+    description: string;
+    required: boolean;
+    additionalProperties?: boolean;
+    default?: unknown;
+}
+export interface ToolDefinition {
+    title: string;
+    description: string;
+    errorPrefix: string;
+    annotations: ToolAnnotations;
+    params: ToolParam[];
+}
+export declare function playgroundUrl(port: number): string;
+export declare const toolDefinitions: Record<string, ToolDefinition>;
+export declare function getSiteToolDefinitions(port: number): Record<string, ToolDefinition>;
+export declare function stringifyError(error: unknown): string;
+/**
+ * Translate internal Playground storage types to user-facing names.
+ */
+export declare function presentStorage(raw: string): string;
+/**
+ * Convert ToolParam[] to a plain JSON Schema object.
+ * Used by WebMCP which expects raw JSON Schema (not Zod).
+ */
+export declare function paramsToJsonSchema(params: ToolParam[]): Record<string, unknown>;

package/tools/tool-executors.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared tool executor functions.
+ *
+ * Both the MCP server and WebMCP call these executors so that tool
+ * output shapes are defined in exactly one place.  Each transport
+ * provides its own ToolClient implementation that normalises I/O
+ * differences (e.g. byte decoding).
+ */
+import type { PlaygroundClient } from '@wp-playground/remote';
+/**
+ * Minimal client interface consumed by tool executors.
+ *
+ * - WebMCP implements this by wrapping PlaygroundClient (decoding
+ *   response bytes via TextDecoder).
+ * - The MCP server implements this by wrapping bridge.sendCommand
+ *   (bytes are already decoded at the bridge-client boundary).
+ */
+export interface ToolClient {
+    run(options: {
+        code: string;
+    }): Promise<{
+        text: string;
+        errors: string;
+        exitCode: number;
+    }>;
+    request(options: {
+        url: string;
+        method: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }): Promise<{
+        text: string;
+        httpStatusCode: number;
+        headers: Record<string, string[]>;
+    }>;
+    goTo(path: string): Promise<void>;
+    getCurrentURL(): Promise<string>;
+    readFileAsText(path: string): Promise<string>;
+    writeFile(path: string, contents: string): Promise<void>;
+    listFiles(path: string): Promise<string[]>;
+    mkdirTree(path: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    rmdir(path: string, options: {
+        recursive: boolean;
+    }): Promise<void>;
+    fileExists(path: string): Promise<boolean>;
+}
+export interface SiteInfo {
+    url: string;
+    documentRoot: string;
+    siteUrl: string;
+    wpVersion: string;
+    phpVersion: string;
+}
+export declare const toolExecutors: Record<string, (client: ToolClient, input: Record<string, unknown>) => Promise<unknown>>;
+/**
+ * Wrap a PlaygroundClient as a ToolClient.
+ *
+ * Most methods pass through directly. Only `run` and `request`
+ * are intercepted to decode PHP/HTTP response bytes into plain
+ * strings via TextDecoder.
+ */
+export declare function createToolClient(client: PlaygroundClient): ToolClient;

package/.eslintrc.json

@@ -1,24 +0,0 @@
-{
-	"extends": ["../../../.eslintrc.json"],
-	"ignorePatterns": ["!**/*"],
-	"overrides": [
-		{
-			"files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
-			"rules": {
-				"no-console": 0
-			}
-		},
-		{
-			"files": ["*.ts", "*.tsx"],
-			"rules": {}
-		},
-		{
-			"files": ["*.js", "*.jsx"],
-			"rules": {}
-		},
-		{
-			"files": ["*.spec.ts"],
-			"rules": {}
-		}
-	]
-}

package/README.md

@@ -1,96 +0,0 @@
-# @wp-playground/mcp
-
-MCP server that connects AI providers to a WordPress Playground running in the browser.
-
-## Usage
-
-### 1. Configure your MCP client
-
-Pick the configuration for your AI tool:
-
-#### Claude Code / Claude Desktop
-
-Add to your Claude Code `.mcp.json` or Claude Desktop `claude_desktop_config.json`:
-
-```json
-{
-	"mcpServers": {
-		"wordpress-playground": {
-			"type": "stdio",
-			"command": "npx",
-			"args": ["@wp-playground/mcp"]
-		}
-	}
-}
-```
-
-#### Gemini CLI
-
-Add to `~/.gemini/settings.json` (or `.gemini/settings.json` in your project):
-
-```json
-{
-	"mcpServers": {
-		"wordpress-playground": {
-			"command": "npx",
-			"args": ["@wp-playground/mcp"]
-		}
-	}
-}
-```
-
-### 2. Open the Playground website
-
-Navigate to https://playground.wordpress.net/?mcp=yes in your browser. The MCP bridge connects automatically.
-
-## Development
-
-When working on the MCP server or the Playground codebase, run from source instead:
-
-### 1. Start the Playground dev server
-
-```bash
-npm run dev
-```
-
-### 2. Configure your MCP client
-
-> **Note:** Your default `node` must be Node 22+. If it isn't, replace `node` in the command below with the full path to Node 22+ (e.g. `/Users/ME/.nvm/versions/node/v22.22.0/bin/node`).
-
-Add to your MCP client config (e.g. Claude Code `.mcp.json` or Claude Desktop `claude_desktop_config.json`):
-
-```json
-{
-	"mcpServers": {
-		"wordpress-playground": {
-			"type": "stdio",
-			"command": "node",
-			"args": ["--experimental-strip-types", "--experimental-transform-types", "--import", "ABS_PATH_TO_PLAYGROUND/packages/meta/src/node-es-module-loader/register.mts", "ABS_PATH_TO_PLAYGROUND/packages/playground/mcp/src/index.ts"]
-		}
-	}
-}
-```
-
-Replace `ABS_PATH_TO_PLAYGROUND` with the absolute path to your local checkout of this repository.
-
-### 3. Open the Playground website
-
-Navigate to http://127.0.0.1:5400/website-server/?mcp=yes in your browser. The MCP bridge connects automatically.
-
-## How it works
-
-```
-AI Client (stdio) → MCP Server (Node.js) → WebSocket (port 7999) → Browser (Playground website)
-```
-
-The MCP server communicates with AI clients via stdio and with the browser via WebSocket. A bridge client (`bridge-client.ts`) integrated into the Playground website via Redux middleware auto-connects to the WebSocket server and proxies commands to the PlaygroundClient API.
-
-## Available tools
-
-**Site management**: `playground_list_sites`, `playground_open_site`, `playground_rename_site`, `playground_save_site`
-
-**Code execution**: `playground_execute_php`, `playground_request`
-
-**Navigation & info**: `playground_navigate`, `playground_get_current_url`, `playground_get_site_info`
-
-**Filesystem**: `playground_read_file`, `playground_write_file`, `playground_list_files`, `playground_mkdir`, `playground_delete_file`, `playground_delete_directory`, `playground_file_exists`