@automattic/mcp-wordpress-remote 0.2.15 → 0.2.17

package/README.md

@@ -45,6 +45,55 @@ Add to your MCP client configuration (e.g., Claude Desktop's `claude_desktop_con
 }
 ```
 
+### Custom Headers
+
+You can add custom headers to all API requests using the `CUSTOM_HEADERS` environment variable. This is useful for API keys, custom authentication, or other header requirements.
+
+#### JSON Format (Recommended):
+```json
+{
+  "mcpServers": {
+    "wordpress": {
+      "command": "npx",
+      "args": ["-y", "@automattic/mcp-wordpress-remote"],
+      "env": {
+        "WP_API_URL": "https://your-wordpress-site.com",
+        "CUSTOM_HEADERS": "{\"X-MCP-API-Key\": \"*Ibo7tweixlbfuwaiufxgakjyefctwajcetb*\", \"X-Custom-Header\": \"value\"}"
+      }
+    }
+  }
+}
+```
+
+#### Comma-Separated Format:
+```json
+{
+  "mcpServers": {
+    "wordpress": {
+      "command": "npx",
+      "args": ["-y", "@automattic/mcp-wordpress-remote"],
+      "env": {
+        "WP_API_URL": "https://your-wordpress-site.com",
+        "CUSTOM_HEADERS": "X-MCP-API-Key:IOskncfyes78U8on3q7ry43o487tybrc,X-Custom-Header:value"
+      }
+    }
+  }
+}
+```
+
+#### Command Line Usage:
+```bash
+CUSTOM_HEADERS='{"X-MCP-API-Key": "wc_mcp_FaQduhQcW0mfVaZgP3yaaqDuXaZ3mw7j"}' \
+WP_API_URL="https://your-site.com" \
+npx @automattic/mcp-wordpress-remote
+```
+
+Custom headers are included in:
+- All WordPress API requests
+- OAuth discovery requests
+- OAuth token exchange requests
+- OAuth client registration requests
+
 ### First Run
 
 1. **Start your MCP client** (Claude Desktop, etc.)

package/dist/lib.d.ts

@@ -12,36 +12,7 @@ interface WordPressResponse {
     [key: string]: any;
 }
 
-declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.1";
-declare enum LogLevel {
-    ERROR = 0,
-    WARN = 1,
-    INFO = 2,
-    DEBUG = 3
-}
-/**
- * Enhanced logging function with levels and categories
- *
- * @param message - The message to log
- * @param level - Log level (default: INFO)
- * @param category - Log category for filtering (default: 'GENERAL')
- * @param args - Additional arguments to log
- */
-declare function log(message: string, level?: LogLevel, category?: string, ...args: any[]): void;
-/**
- * Convenience logging functions
- */
-declare const logger: {
-    error: (message: string, category?: string, ...args: any[]) => void;
-    warn: (message: string, category?: string, ...args: any[]) => void;
-    info: (message: string, category?: string, ...args: any[]) => void;
-    debug: (message: string, category?: string, ...args: any[]) => void;
-    auth: (message: string, level?: LogLevel, ...args: any[]) => void;
-    oauth: (message: string, level?: LogLevel, ...args: any[]) => void;
-    api: (message: string, level?: LogLevel, ...args: any[]) => void;
-    config: (message: string, level?: LogLevel, ...args: any[]) => void;
-};
-
+declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.17";
 /**
  * Centralized configuration for MCP WordPress Remote
  * All default values are defined here and can be overridden via environment variables
@@ -69,6 +40,7 @@ declare const CONFIG: {
     readonly JWT_TOKEN: string | undefined;
     readonly WOO_CUSTOMER_KEY: string | undefined;
     readonly WOO_CUSTOMER_SECRET: string | undefined;
+    readonly CUSTOM_HEADERS: string;
     readonly NODE_ENV: string;
 };
 /**
@@ -113,6 +85,8 @@ declare const getConfig: () => {
     wooCustomerKey: string | undefined;
     /** WooCommerce customer secret */
     wooCustomerSecret: string | undefined;
+    /** Custom headers for API requests */
+    customHeaders: string;
     /** Current environment */
     nodeEnv: string;
 };
@@ -120,6 +94,18 @@ declare const getConfig: () => {
  * Get default OAuth scopes
  */
 declare function getDefaultOAuthScopes(): string[];
+/**
+ * Parse custom headers from environment variable
+ * Supports both JSON format and comma-separated format
+ *
+ * JSON format: {"X-MCP-API-Key": "value", "X-Custom-Header": "value"}
+ * Comma format: X-MCP-API-Key:value,X-Custom-Header:value
+ */
+declare function parseCustomHeaders(customHeadersString: string): Record<string, string>;
+/**
+ * Get parsed custom headers
+ */
+declare function getCustomHeaders(): Record<string, string>;
 /**
  * Validation function for required configuration
  */
@@ -128,6 +114,37 @@ declare function validateConfig(): {
     errors: string[];
 };
 
+declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+/**
+ * Enhanced logging function with levels and categories
+ *
+ * @param message - The message to log
+ * @param level - Log level (default: INFO)
+ * @param category - Log category for filtering (default: 'GENERAL')
+ * @param args - Additional arguments to log
+ */
+declare function log(message: string, level?: LogLevel, category?: string, ...args: any[]): void;
+/**
+ * Convenience logging functions
+ */
+declare const logger: {
+    error: (message: string, category?: string, ...args: any[]) => void;
+    warn: (message: string, category?: string, ...args: any[]) => void;
+    info: (message: string, category?: string, ...args: any[]) => void;
+    debug: (message: string, category?: string, ...args: any[]) => void;
+    auth: (message: string, level?: LogLevel, ...args: any[]) => void;
+    oauth: (message: string, level?: LogLevel, ...args: any[]) => void;
+    api: (message: string, level?: LogLevel, ...args: any[]) => void;
+    config: (message: string, level?: LogLevel, ...args: any[]) => void;
+};
+
+declare function wpRequest(requestData: any, useJsonRpc?: boolean): Promise<WordPressResponse>;
+
 /**
  * WordPress OAuth types and error definitions
  * Updated for MCP Authorization specification 2025-06-18 compliance
@@ -202,4 +219,4 @@ declare function isConfigError(error: any): error is ConfigError;
 declare function isAuthError(error: any): error is AuthError;
 declare function isAPIError(error: any): error is APIError;
 
-export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getConfig, getDefaultOAuthScopes, isAPIError, isAuthError, isConfigError, isOAuthError, log, logger, validateConfig };
+export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getConfig, getCustomHeaders, getDefaultOAuthScopes, isAPIError, isAuthError, isConfigError, isOAuthError, log, logger, parseCustomHeaders, validateConfig, wpRequest };