Sync fork with upstream (media cleanup merged upstream as InstaWP#13)

CLAUDE.md

@@ -151,7 +151,7 @@ Handles ALL taxonomies (categories, tags, custom taxonomies) with a single set o
 - `test_site` - Test connection to a WordPress site
 
 #### **Other Specialized Tools**
-- **Media** (`media.ts`): Media library management (~5 tools)
+- **Media** (`media.ts`): Media library management (5 canonical tools plus legacy `edit_media` alias)
 - **Users** (`users.ts`): User management (~5 tools)
 - **Comments** (`comments.ts`): Comment management (~5 tools)
 - **Plugins** (`plugins.ts`): Plugin activation/deactivation (~5 tools)
@@ -249,4 +249,4 @@ The server integrates with Claude Desktop via the configuration in `claude_deskt
 - `axios`: HTTP client for WordPress REST API
 - `zod`: Runtime type validation for tool inputs
 - `dotenv`: Environment variable management
-- `tsx`: TypeScript execution for development
+- `tsx`: TypeScript execution for development

README.md

@@ -59,9 +59,10 @@ Handles ALL taxonomies (categories, tags, custom taxonomies) with a single set o
 - **Media:**
   - `list_media`: List all media items (supports pagination and searching).
   - `get_media`: Retrieve a specific media item by ID.
-  - `create_media`: Create a new media item from a URL.
+  - `create_media`: Create a new media item from a URL or local file path.
   - `update_media`: Update an existing media item.
   - `delete_media`: Delete a media item.
+  - `edit_media`: Legacy alias for `update_media` kept for backward compatibility.
 - **Users:**
   - `list_users`: List all users with filtering, sorting, and pagination options.
   - `get_user`: Retrieve a specific user by ID.
@@ -88,6 +89,39 @@ Handles ALL taxonomies (categories, tags, custom taxonomies) with a single set o
 
 ### **Key Advantages**
 
+#### Media Upload Workflows
+
+Upload a local screenshot from the same machine running the MCP server:
+
+```json
+{
+  "file_path": "./screenshots/homepage.png",
+  "title": "Homepage Screenshot",
+  "alt_text": "Homepage screenshot showing the hero section"
+}
+```
+
+Upload media from a remote URL:
+
+```json
+{
+  "source_url": "https://example.com/assets/hero-image.png",
+  "title": "Hero Image",
+  "caption": "Imported from the design system"
+}
+```
+
+Use the returned media ID as featured media on new content:
+
+```json
+{
+  "content_type": "post",
+  "title": "Release Notes",
+  "content": "<p>Launch summary...</p>",
+  "featured_media": 123
+}
+```
+
 #### Smart URL Resolution
 
 The `find_content_by_url` tool can:
@@ -360,7 +394,7 @@ src/
     ├── site-management.ts      # Site management (3 tools)
     ├── unified-content.ts      # Universal content management (8 tools)
     ├── unified-taxonomies.ts   # Universal taxonomy management (8 tools)
-    ├── media.ts               # Media management (~5 tools)
+    ├── media.ts               # Media management (5 canonical tools + edit_media alias)
     ├── users.ts               # User management (~5 tools)
     ├── comments.ts            # Comment management (~5 tools)
     ├── plugins.ts             # Plugin management (~5 tools)

package.json

@@ -32,6 +32,7 @@
     "@modelcontextprotocol/sdk": "^1.4.1",
     "axios": "^1.6.7",
     "dotenv": "^16.4.5",
+    "form-data": "^4.0.5",
     "fs-extra": "^11.2.0",
     "marked": "^17.0.0",
     "zod": "^3.23.8",