localwp-mcp 0.1.1 → 0.1.3

package/README.md

@@ -7,6 +7,8 @@ It automatically finds your Local sites, uses the correct Local PHP and MySQL ru
 ## 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
@@ -104,6 +106,29 @@ Use:
 - `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:
@@ -149,10 +174,18 @@ The `full` backup format is folder-based and includes the site's `app`, `conf`,
 ### 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`
@@ -212,28 +245,6 @@ Those tools are the fastest way to see whether the problem is:
 - MySQL connectivity
 - missing or stopped Local services
 
-## From Source
-
-If you are running from a local clone instead of npm:
-
-```bash
-pnpm install
-pnpm build
-```
-
-Then point your MCP client at:
-
-```json
-{
-  "mcpServers": {
-    "localwp": {
-      "command": "node",
-      "args": ["/path/to/localwp-mcp/dist/index.js"]
-    }
-  }
-}
-```
-
 ## For Contributors
 
 Contributor and maintainer docs live outside the main user guide:

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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"}

package/dist/site-files.d.ts

@@ -0,0 +1,196 @@
+import type { SiteSelection } from "./types.js";
+interface ResolvedSiteFileTarget {
+    siteRoot: string;
+    siteRootReal: string;
+    absolutePath: string;
+    relativePath: string;
+    exists: boolean;
+}
+interface SiteFileListEntry {
+    path: string;
+    absolutePath: string;
+    kind: "file" | "directory" | "symlink" | "other";
+    sizeBytes: number;
+    modifiedAt: string;
+}
+export declare function clampSiteFileReadBytes(value: number | undefined): number;
+export declare function clampSiteFileListEntries(value: number | undefined): number;
+export declare function clampSiteFileSearchMatches(value: number | undefined): number;
+export declare function listSiteFiles(selection: SiteSelection, options?: {
+    directoryPath?: string;
+    recursive?: boolean;
+    maxDepth?: number;
+    maxEntries?: number;
+    includeHidden?: boolean;
+}): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    directoryPath: string;
+    absoluteDirectoryPath: string;
+    recursive: boolean;
+    maxDepth: number;
+    maxEntries: number;
+    includeHidden: boolean;
+    truncated: boolean;
+    entries: SiteFileListEntry[];
+}>;
+export declare function readSiteFile(selection: SiteSelection, options: {
+    filePath: string;
+    maxBytes?: number;
+}): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    filePath: string;
+    absolutePath: string;
+    sizeBytes: number;
+    returnedBytes: number;
+    maxBytes: number;
+    truncated: boolean;
+    content: string;
+}>;
+export declare function searchSiteFiles(selection: SiteSelection, options: {
+    query: string;
+    directoryPath?: string;
+    caseSensitive?: boolean;
+    includeHidden?: boolean;
+    maxDepth?: number;
+    maxMatches?: number;
+}): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    query: string;
+    caseSensitive: boolean;
+    directoryPath: string;
+    absoluteDirectoryPath: string;
+    includeHidden: boolean;
+    maxDepth: number;
+    maxMatches: number;
+    scannedFiles: number;
+    skippedBinaryFiles: number;
+    skippedLargeFiles: number;
+    truncated: boolean;
+    matches: {
+        path: string;
+        absolutePath: string;
+        line: number;
+        column: number;
+        excerpt: string;
+    }[];
+}>;
+export declare function writeSiteFile(selection: SiteSelection, options: {
+    filePath: string;
+    content: string;
+    createDirectories?: boolean;
+    overwrite?: boolean;
+}): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    filePath: string;
+    absolutePath: string;
+    existedBefore: boolean;
+    overwrite: boolean;
+    createdDirectories: boolean;
+    bytesWritten: number;
+}>;
+export declare function deleteSiteFile(selection: SiteSelection, options: {
+    targetPath: string;
+    recursive?: boolean;
+    missingOk?: boolean;
+}): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    targetPath: string;
+    absolutePath: string;
+    existedBefore: boolean;
+    deleted: boolean;
+    recursive: boolean;
+    missingOk: boolean;
+    kind?: undefined;
+} | {
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    };
+    selectionMethod: string;
+    targetPath: string;
+    absolutePath: string;
+    existedBefore: boolean;
+    deleted: boolean;
+    kind: "file" | "directory" | "symlink" | "other";
+    recursive: boolean;
+    missingOk: boolean;
+}>;
+export declare function resolveSiteScopedPath(siteRoot: string, requestedPath: string, options?: {
+    allowSiteRoot?: boolean;
+    allowMissingTarget?: boolean;
+}): Promise<ResolvedSiteFileTarget>;
+export {};