localwp-mcp 0.1.2 → 0.1.4

package/LICENSE

@@ -1,15 +1,15 @@
-ISC License
-
-Copyright (c) 2026
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
+ISC License
+
+Copyright (c) 2026
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,221 +1,254 @@
-# localwp-mcp
-
-`localwp-mcp` gives AI agents direct access to LocalWP sites through MCP.
-
-It automatically finds your Local sites, uses the correct Local PHP and MySQL runtimes for each one, and lets an agent work with WordPress through WP-CLI, MySQL, logs, diagnostics, backups, and restore flows.
-
-## What You Can Do
-
-- inspect Local sites and their runtime details
-- run WP-CLI against the correct site
-- query the WordPress database
-- allow full database writes when you want unrestricted local development
-- read recent logs and run site health checks
-- export, import, back up, and restore LocalWP sites
-
-## Install
-
-Use `npx` in your MCP client:
-
-```json
-{
-  "mcpServers": {
-    "localwp": {
-      "command": "npx",
-      "args": ["localwp-mcp"],
-      "env": {
-        "LOCALWP_MCP_PROFILE": "safe"
-      }
-    }
-  }
-}
-```
-
-You can also install it globally:
-
-```bash
-npm install -g localwp-mcp
-```
-
-Then use:
-
-```json
-{
-  "mcpServers": {
-    "localwp": {
-      "command": "localwp-mcp",
-      "env": {
-        "LOCALWP_MCP_PROFILE": "safe"
-      }
-    }
-  }
-}
-```
-
-If you want the MCP to focus on one site by default, set:
-
-```json
-{
-  "LOCAL_SITE_NAME": "example-site"
-}
-```
-
-## Access Modes
-
-`localwp-mcp` has 2 access modes:
-
-- `safe`
-  Best default for most people. Safe WordPress inspection commands, diagnostics, logs, database reads, and backup/export flows.
-- `full-access`
-  Best when you want the agent to fully work on your local site, including SQL writes, imports, and restore operations.
-
-`safe` is the default.
-
-To enable full local access:
-
-```json
-{
-  "LOCALWP_MCP_PROFILE": "full-access"
-}
-```
-
-## First Things To Try
-
-Start with:
-
-- `local_environment_check`
-- `local_doctor`
-- `list_local_sites`
-
-Those will tell you:
-
-- which Local sites were discovered
-- whether the site is running
-- which Local runtimes were resolved
-- whether WP-CLI and MySQL are reachable
-
-## Common Workflows
-
-### Inspect a Site
-
-Use:
-
-- `local_site_info`
-- `local_doctor`
-- `local_logs`
-
-### Work With WordPress
-
-Use:
-
-- `execute_wp_cli`
-
-Examples:
-
-- list plugins
-- inspect options
-- list posts or users
-- run plugin-specific WP-CLI commands
-
-### Work With the Database
-
-Use:
-
-- `mysql_query`
-  Read-only SQL in `safe`
-- `mysql_execute`
-  Full SQL execution in `full-access`
-- `mysql_schema`
-  Table listing and table description helpers
-
-### Back Up or Restore a Site
-
-Use:
-
-- `backup_site`
-- `db_export`
-- `db_import`
-- `restore_backup`
-
-`backup_site` supports:
-
-- `database`
-- `full`
-
-The `full` backup format is folder-based and includes the site's `app`, `conf`, and `logs` directories plus a fresh SQL dump.
-
-## Built-In Capabilities
-
-### Tools
-
-- `list_local_sites`
-- `local_environment_check`
-- `local_doctor`
-- `local_logs`
-- `local_site_info`
-- `execute_wp_cli`
-- `mysql_query`
-- `mysql_execute`
-- `mysql_schema`
-- `db_export`
-- `db_import`
-- `backup_site`
-- `restore_backup`
-
-### MCP Resources
-
-- `localwp://sites`
-- `localwp://sites/{siteName}/summary`
-- `localwp://sites/{siteName}/doctor`
-- `localwp://sites/{siteName}/logs`
-
-### MCP Prompts
-
-- `diagnose_local_site`
-- `restore_local_site`
-
-## Platform Support
-
-`localwp-mcp` is designed for:
-
-- macOS
-- Windows
-- Linux
-
-It supports both current Local `lightning-services` layouts and older `site-binaries` layouts.
-
-## Useful Environment Variables
-
-Most users only need these:
-
-- `LOCALWP_MCP_PROFILE`
-- `LOCAL_SITE_NAME`
-- `LOCAL_SITE_ID`
-- `LOCALWP_MCP_BACKUPS_DIR`
-
-Advanced override variables also exist for custom Local layouts, but most installations do not need them.
-
-## Troubleshooting
-
-If the MCP does not find your site or cannot run WP-CLI/MySQL:
-
-1. Start the site in Local.
-2. Run `local_environment_check`.
-3. Run `local_doctor`.
-4. Check `local_logs`.
-
-Those tools are the fastest way to see whether the problem is:
-
-- site selection
-- Local metadata resolution
-- WP-CLI resolution
-- MySQL connectivity
-- missing or stopped Local services
-
-## For Contributors
-
-Contributor and maintainer docs live outside the main user guide:
-
-- [CONTRIBUTING.md](./CONTRIBUTING.md)
-- [SECURITY.md](./SECURITY.md)
-- [Maintainer Docs](./docs/maintainers/README.md)
+# localwp-mcp
+
+`localwp-mcp` gives AI agents direct access to LocalWP sites through MCP.
+
+It automatically finds your Local sites, uses the correct Local PHP and MySQL runtimes for each one, and lets an agent work with WordPress through WP-CLI, MySQL, logs, diagnostics, backups, and restore flows.
+
+## What You Can Do
+
+- inspect Local sites and their runtime details
+- start, stop, and restart Local sites
+- list, read, search, write, and delete files inside a selected Local site
+- run WP-CLI against the correct site
+- query the WordPress database
+- allow full database writes when you want unrestricted local development
+- read recent logs and run site health checks
+- export, import, back up, and restore LocalWP sites
+
+## Install
+
+Use `npx` in your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "localwp": {
+      "command": "npx",
+      "args": ["localwp-mcp"],
+      "env": {
+        "LOCALWP_MCP_PROFILE": "safe"
+      }
+    }
+  }
+}
+```
+
+You can also install it globally:
+
+```bash
+npm install -g localwp-mcp
+```
+
+Then use:
+
+```json
+{
+  "mcpServers": {
+    "localwp": {
+      "command": "localwp-mcp",
+      "env": {
+        "LOCALWP_MCP_PROFILE": "safe"
+      }
+    }
+  }
+}
+```
+
+If you want the MCP to focus on one site by default, set:
+
+```json
+{
+  "LOCAL_SITE_NAME": "example-site"
+}
+```
+
+## Access Modes
+
+`localwp-mcp` has 2 access modes:
+
+- `safe`
+  Best default for most people. Safe WordPress inspection commands, diagnostics, logs, database reads, and backup/export flows.
+- `full-access`
+  Best when you want the agent to fully work on your local site, including SQL writes, imports, and restore operations.
+
+`safe` is the default.
+
+To enable full local access:
+
+```json
+{
+  "LOCALWP_MCP_PROFILE": "full-access"
+}
+```
+
+## First Things To Try
+
+Start with:
+
+- `local_environment_check`
+- `local_doctor`
+- `list_local_sites`
+
+Those will tell you:
+
+- which Local sites were discovered
+- whether the site is running
+- which Local runtimes were resolved
+- whether WP-CLI and MySQL are reachable
+
+## Common Workflows
+
+### Inspect a Site
+
+Use:
+
+- `local_site_info`
+- `local_doctor`
+- `local_logs`
+
+### Work With Site Files
+
+Use:
+
+- `list_site_files`
+- `read_site_file`
+- `search_site_files`
+- `write_site_file`
+- `delete_site_file`
+
+These tools are always scoped to the selected site's root directory.
+
+- In `safe`, you can list, read, and search files.
+- In `full-access`, you can also write and delete files.
+
+### Control a Local Site
+
+Use:
+
+- `start_local_site`
+- `stop_local_site`
+- `restart_local_site`
+
+### Work With WordPress
+
+Use:
+
+- `execute_wp_cli`
+
+Examples:
+
+- list plugins
+- inspect options
+- list posts or users
+- run plugin-specific WP-CLI commands
+
+### Work With the Database
+
+Use:
+
+- `mysql_query`
+  Read-only SQL in `safe`
+- `mysql_execute`
+  Full SQL execution in `full-access`
+- `mysql_schema`
+  Table listing and table description helpers
+
+### Back Up or Restore a Site
+
+Use:
+
+- `backup_site`
+- `db_export`
+- `db_import`
+- `restore_backup`
+
+`backup_site` supports:
+
+- `database`
+- `full`
+
+The `full` backup format is folder-based and includes the site's `app`, `conf`, and `logs` directories plus a fresh SQL dump.
+
+## Built-In Capabilities
+
+### Tools
+
+- `list_local_sites`
+- `start_local_site`
+- `stop_local_site`
+- `restart_local_site`
+- `local_environment_check`
+- `local_doctor`
+- `local_logs`
+- `local_site_info`
+- `list_site_files`
+- `read_site_file`
+- `search_site_files`
+- `write_site_file`
+- `delete_site_file`
+- `execute_wp_cli`
+- `mysql_query`
+- `mysql_execute`
+- `mysql_schema`
+- `db_export`
+- `db_import`
+- `backup_site`
+- `restore_backup`
+
+### MCP Resources
+
+- `localwp://sites`
+- `localwp://sites/{siteName}/summary`
+- `localwp://sites/{siteName}/doctor`
+- `localwp://sites/{siteName}/logs`
+
+### MCP Prompts
+
+- `diagnose_local_site`
+- `restore_local_site`
+
+## Platform Support
+
+`localwp-mcp` is designed for:
+
+- macOS
+- Windows
+- Linux
+
+It supports both current Local `lightning-services` layouts and older `site-binaries` layouts.
+
+## Useful Environment Variables
+
+Most users only need these:
+
+- `LOCALWP_MCP_PROFILE`
+- `LOCAL_SITE_NAME`
+- `LOCAL_SITE_ID`
+- `LOCALWP_MCP_BACKUPS_DIR`
+
+Advanced override variables also exist for custom Local layouts, but most installations do not need them.
+
+## Troubleshooting
+
+If the MCP does not find your site or cannot run WP-CLI/MySQL:
+
+1. Start the site in Local.
+2. Run `local_environment_check`.
+3. Run `local_doctor`.
+4. Check `local_logs`.
+
+Those tools are the fastest way to see whether the problem is:
+
+- site selection
+- Local metadata resolution
+- WP-CLI resolution
+- MySQL connectivity
+- missing or stopped Local services
+
+## For Contributors
+
+Contributor and maintainer docs live outside the main user guide:
+
+- [CONTRIBUTING.md](./CONTRIBUTING.md)
+- [SECURITY.md](./SECURITY.md)
+- [Maintainer Docs](./docs/maintainers/README.md)

package/dist/config.d.ts

@@ -9,6 +9,7 @@ export declare const config: {
     readonly localLightningServicesDirs: string[];
     readonly localSitesJson: string;
     readonly localSiteStatusesJson: string;
+    readonly localGraphqlConnectionInfoJson: string;
     readonly localWpCliPharCandidates: string[];
     readonly localWpCliConfigCandidates: string[];
     readonly localHelperBinDirCandidates: string[];

package/dist/config.js

@@ -27,6 +27,8 @@ export const config = {
         path.join(process.env.LOCAL_APP_SUPPORT_DIR || defaultLocalAppSupportDir, "sites.json"),
     localSiteStatusesJson: process.env.LOCAL_SITE_STATUSES_JSON ||
         path.join(process.env.LOCAL_APP_SUPPORT_DIR || defaultLocalAppSupportDir, "site-statuses.json"),
+    localGraphqlConnectionInfoJson: process.env.LOCAL_GRAPHQL_CONNECTION_INFO ||
+        path.join(process.env.LOCAL_APP_SUPPORT_DIR || defaultLocalAppSupportDir, "graphql-connection-info.json"),
     localWpCliPharCandidates: process.env.LOCAL_WP_CLI_PHAR
         ? [process.env.LOCAL_WP_CLI_PHAR]
         : getWpCliPharCandidates(platform, localExtraResourcesDirs),

package/dist/config.js.map

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

package/dist/local-graphql.d.ts

@@ -0,0 +1,8 @@
+import type { LocalSiteLifecycleMutationResult } from "./types.js";
+interface LocalGraphqlError {
+    message?: string;
+}
+export declare function startLocalSite(siteId: string): Promise<LocalSiteLifecycleMutationResult>;
+export declare function stopLocalSite(siteId: string): Promise<LocalSiteLifecycleMutationResult>;
+export declare function formatLocalGraphqlErrors(errors?: LocalGraphqlError[]): string;
+export {};

package/dist/local-graphql.js

@@ -0,0 +1,78 @@
+import { readFile } from "fs/promises";
+import { config } from "./config.js";
+import { assertReadable } from "./process-utils.js";
+export async function startLocalSite(siteId) {
+    return runSiteLifecycleMutation("startSite", siteId);
+}
+export async function stopLocalSite(siteId) {
+    return runSiteLifecycleMutation("stopSite", siteId);
+}
+export function formatLocalGraphqlErrors(errors = []) {
+    const messages = errors
+        .map((error) => error.message?.trim())
+        .filter((message) => Boolean(message));
+    return messages.join("; ") || "Local GraphQL request failed.";
+}
+async function runSiteLifecycleMutation(mutationName, siteId) {
+    const query = `mutation ($siteID: ID!) { ${mutationName}(id: $siteID) { id name status } }`;
+    const payload = await requestLocalGraphql(query, { siteID: siteId });
+    const result = payload[mutationName];
+    if (!result) {
+        throw new Error(`Local GraphQL did not return '${mutationName}' data.`);
+    }
+    return result;
+}
+async function requestLocalGraphql(query, variables) {
+    const connection = await readLocalGraphqlConnectionInfo();
+    let response;
+    try {
+        response = await fetch(connection.url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${connection.authToken}`,
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to reach Local's GraphQL API at ${connection.url}. Make sure the Local app is running. ${message}`);
+    }
+    if (!response.ok) {
+        throw new Error(`Local GraphQL API responded with HTTP ${response.status} ${response.statusText}.`);
+    }
+    const payload = (await response.json());
+    if (payload.errors?.length) {
+        throw new Error(formatLocalGraphqlErrors(payload.errors));
+    }
+    if (!payload.data) {
+        throw new Error("Local GraphQL API returned no data.");
+    }
+    return payload.data;
+}
+async function readLocalGraphqlConnectionInfo() {
+    await assertReadable(config.localGraphqlConnectionInfoJson, "Local GraphQL connection info is not readable. Open the Local app first");
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(config.localGraphqlConnectionInfoJson, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read Local GraphQL connection info from '${config.localGraphqlConnectionInfoJson}': ${message}`);
+    }
+    if (!isLocalGraphqlConnectionInfo(parsed)) {
+        throw new Error(`Local GraphQL connection info is invalid: ${config.localGraphqlConnectionInfoJson}`);
+    }
+    return parsed;
+}
+function isLocalGraphqlConnectionInfo(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.port === "number" &&
+        typeof candidate.authToken === "string" &&
+        typeof candidate.url === "string");
+}
+//# sourceMappingURL=local-graphql.js.map

package/dist/local-graphql.js.map

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