import { z } from "zod";
import {
// TODO: Add these imports as you implement the functions in wordpress/api.js
uploadMedia, listMedia, searchMedia, editMediaMetadata, deleteMedia, setFeaturedImage, optimizeMedia, getMediaDetails, bulkDeleteMedia } from "../wordpress/api.js";
/**
* Register all media-related tools with the MCP server
*/
export function registerMediaTools(server) {
// Upload Media Tool
server.tool("upload-media", "Upload media files to WordPress from local paths or URLs", {
source: z.string().describe("Local file path or URL to upload"),
title: z.string().optional().describe("Media title"),
caption: z.string().optional().describe("Media caption"),
altText: z.string().optional().describe("Alt text for accessibility"),
description: z.string().optional().describe("Media description")
}, async ({ source, title, caption, altText, description }) => {
try {
// TODO: Implement uploadMedia in wordpress/api.js
const result = await uploadMedia(source, { title, caption, altText, description });
return {
content: [{
type: "text",
text: "⚠️ upload-media tool not yet implemented. Please add uploadMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error uploading media:", error);
return {
content: [{
type: "text",
text: `Error uploading media: ${errorMessage}`
}],
isError: true
};
}
});
// List Media Tool
server.tool("list-media", "List WordPress media library with pagination and filters", {
page: z.number().default(1).describe("Page number (default: 1)"),
perPage: z.number().max(100).default(20).describe("Items per page (max: 100)"),
mediaType: z.enum(["image", "video", "audio", "application", "any"]).default("any").describe("Filter by media type"),
mimeType: z.string().optional().describe("Specific MIME type (e.g., 'image/jpeg')"),
orderBy: z.enum(["date", "id", "title", "slug"]).default("date").describe("Order media by"),
order: z.enum(["asc", "desc"]).default("desc").describe("Sort order"),
parent: z.number().optional().describe("Filter by parent post ID")
}, async ({ page, perPage, mediaType, mimeType, orderBy, order, parent }) => {
try {
// TODO: Implement listMedia in wordpress/api.js
const result = await listMedia({ page, perPage, mediaType, mimeType, orderBy, order, parent });
return {
content: [{
type: "text",
text: "⚠️ list-media tool not yet implemented. Please add listMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error listing media: ${errorMessage}`
}],
isError: true
};
}
});
// Search Media Tool
server.tool("search-media", "Search WordPress media library by keyword, type, or date", {
query: z.string().describe("Search query for title, caption, or filename"),
mediaType: z.enum(["image", "video", "audio", "application", "any"]).default("any").describe("Filter by media type"),
dateAfter: z.string().optional().describe("Find media after this date (ISO format)"),
dateBefore: z.string().optional().describe("Find media before this date (ISO format)"),
limit: z.number().max(50).default(20).describe("Maximum results to return")
}, async ({ query, mediaType, dateAfter, dateBefore, limit }) => {
try {
// TODO: Implement searchMedia in wordpress/api.js
const result = await searchMedia({ query, mediaType, dateAfter, dateBefore, limit });
return {
content: [{
type: "text",
text: "⚠️ search-media tool not yet implemented. Please add searchMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error searching media: ${errorMessage}`
}],
isError: true
};
}
});
// Edit Media Metadata Tool
server.tool("edit-media-metadata", "Update title, caption, alt text, and description of media files", {
mediaId: z.number().describe("ID of the media item to edit"),
title: z.string().optional().describe("New media title"),
caption: z.string().optional().describe("New media caption"),
altText: z.string().optional().describe("New alt text for accessibility"),
description: z.string().optional().describe("New media description")
}, async ({ mediaId, title, caption, altText, description }) => {
try {
// TODO: Implement editMediaMetadata in wordpress/api.js
const result = await editMediaMetadata(mediaId, { title, caption, altText, description });
return {
content: [{
type: "text",
text: "⚠️ edit-media-metadata tool not yet implemented. Please add editMediaMetadata function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error editing media metadata: ${errorMessage}`
}],
isError: true
};
}
});
// Delete Media Tool
server.tool("delete-media", "Permanently delete media files from WordPress library", {
mediaId: z.number().describe("ID of the media item to delete"),
force: z.boolean().default(true).describe("Force delete (bypass trash for media)")
}, async ({ mediaId, force }) => {
try {
// TODO: Implement deleteMedia in wordpress/api.js
const result = await deleteMedia(mediaId, force);
return {
content: [{
type: "text",
text: "⚠️ delete-media tool not yet implemented. Please add deleteMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error deleting media: ${errorMessage}`
}],
isError: true
};
}
});
// Set Featured Image Tool
server.tool("set-featured-image", "Assign a featured image to a WordPress post", {
postId: z.number().describe("ID of the post to update"),
mediaId: z.number().describe("ID of the media item to set as featured image")
}, async ({ postId, mediaId }) => {
try {
// TODO: Implement setFeaturedImage in wordpress/api.js
const result = await setFeaturedImage(postId, mediaId);
return {
content: [{
type: "text",
text: "⚠️ set-featured-image tool not yet implemented. Please add setFeaturedImage function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error setting featured image: ${errorMessage}`
}],
isError: true
};
}
});
// Optimize Media Tool
server.tool("optimize-media", "Compress and optimize images using external API (e.g., TinyPNG)", {
mediaId: z.number().describe("ID of the media item to optimize"),
quality: z.number().min(10).max(100).default(80).describe("Compression quality (10-100)"),
replaceOriginal: z.boolean().default(false).describe("Replace original file or create new version")
}, async ({ mediaId, quality, replaceOriginal }) => {
try {
// TODO: Implement optimizeMedia in wordpress/api.js
const result = await optimizeMedia(mediaId, { quality, replaceOriginal });
return {
content: [{
type: "text",
text: "⚠️ optimize-media tool not yet implemented. Please add optimizeMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error optimizing media: ${errorMessage}`
}],
isError: true
};
}
});
// Get Media Details Tool
server.tool("get-media-details", "Retrieve detailed information about a media file", {
mediaId: z.number().describe("ID of the media item to retrieve")
}, async ({ mediaId }) => {
try {
// TODO: Implement getMediaDetails in wordpress/api.js
const result = await getMediaDetails(mediaId);
return {
content: [{
type: "text",
text: "⚠️ get-media-details tool not yet implemented. Please add getMediaDetails function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error retrieving media details: ${errorMessage}`
}],
isError: true
};
}
});
// Bulk Delete Media Tool
server.tool("bulk-delete-media", "Delete multiple media files at once", {
mediaIds: z.array(z.number()).describe("Array of media IDs to delete"),
force: z.boolean().default(true).describe("Force delete (bypass trash)")
}, async ({ mediaIds, force }) => {
try {
if (mediaIds.length === 0) {
return {
content: [{
type: "text",
text: "No media IDs provided for bulk deletion"
}],
isError: true
};
}
// TODO: Implement bulkDeleteMedia in wordpress/api.js
const result = await bulkDeleteMedia(mediaIds, force);
return {
content: [{
type: "text",
text: "⚠️ bulk-delete-media tool not yet implemented. Please add bulkDeleteMedia function to wordpress/api.js"
}],
isError: true
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
return {
content: [{
type: "text",
text: `Error bulk deleting media: ${errorMessage}`
}],
isError: true
};
}
});
}
