@junis/ghost-mcp 0.2.1 → 0.4.0

package/build/server.js

@@ -46,6 +46,16 @@ const webhooks_1 = require("./tools/webhooks");
 (0, webhooks_1.registerWebhookTools)(server);
 const upload_1 = require("./tools/upload");
 (0, upload_1.registerUploadTools)(server);
+const pages_1 = require("./tools/pages");
+(0, pages_1.registerPageTools)(server);
+const site_1 = require("./tools/site");
+(0, site_1.registerSiteTools)(server);
+const settings_1 = require("./tools/settings");
+(0, settings_1.registerSettingsTools)(server);
+const themes_1 = require("./tools/themes");
+(0, themes_1.registerThemeTools)(server);
+const redirects_1 = require("./tools/redirects");
+(0, redirects_1.registerRedirectsAndRoutesTools)(server);
 const prompts_1 = require("./prompts");
 (0, prompts_1.registerPrompts)(server);
 // Set up and connect to the standard I/O transport

package/build/tools/pages.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPageTools = registerPageTools;
+// src/tools/pages.ts
+const zod_1 = require("zod");
+const ghostApi_1 = require("../ghostApi");
+const browseParams = {
+    filter: zod_1.z.string().optional(),
+    limit: zod_1.z.number().optional(),
+    page: zod_1.z.number().optional(),
+    order: zod_1.z.string().optional(),
+};
+const readParams = {
+    id: zod_1.z.string().optional(),
+    slug: zod_1.z.string().optional(),
+};
+const addParams = {
+    title: zod_1.z.string(),
+    html: zod_1.z.string().optional(),
+    lexical: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string() })).optional(),
+    codeinjection_head: zod_1.z.string().optional(),
+    codeinjection_foot: zod_1.z.string().optional(),
+    meta_title: zod_1.z.string().optional(),
+    meta_description: zod_1.z.string().optional(),
+    slug: zod_1.z.string().optional(),
+    feature_image: zod_1.z.string().optional(),
+    og_title: zod_1.z.string().optional(),
+    og_description: zod_1.z.string().optional(),
+    custom_excerpt: zod_1.z.string().optional(),
+};
+const editParams = {
+    id: zod_1.z.string(),
+    title: zod_1.z.string().optional(),
+    html: zod_1.z.string().optional(),
+    lexical: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    updated_at: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string() })).optional(),
+    codeinjection_head: zod_1.z.string().optional(),
+    codeinjection_foot: zod_1.z.string().optional(),
+    meta_title: zod_1.z.string().optional(),
+    meta_description: zod_1.z.string().optional(),
+    slug: zod_1.z.string().optional(),
+    feature_image: zod_1.z.string().optional(),
+    og_title: zod_1.z.string().optional(),
+    og_description: zod_1.z.string().optional(),
+    custom_excerpt: zod_1.z.string().optional(),
+};
+const deleteParams = {
+    id: zod_1.z.string(),
+};
+function registerPageTools(server) {
+    server.tool("pages_browse", "Browse Ghost pages (About, Contact, etc.)", browseParams, async (args, _extra) => {
+        const pages = await ghostApi_1.ghostApiClient.pages.browse(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(pages, null, 2) }],
+        };
+    });
+    server.tool("pages_read", "Read a single Ghost page by id or slug", readParams, async (args, _extra) => {
+        const page = await ghostApi_1.ghostApiClient.pages.read(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(page, null, 2) }],
+        };
+    });
+    server.tool("pages_add", "Create a new Ghost page", addParams, async (args, _extra) => {
+        const options = args.html ? { source: "html" } : undefined;
+        const page = await ghostApi_1.ghostApiClient.pages.add(args, options);
+        return {
+            content: [{ type: "text", text: JSON.stringify(page, null, 2) }],
+        };
+    });
+    server.tool("pages_edit", "Edit an existing Ghost page", editParams, async (args, _extra) => {
+        const options = args.html ? { source: "html" } : undefined;
+        const page = await ghostApi_1.ghostApiClient.pages.edit(args, options);
+        return {
+            content: [{ type: "text", text: JSON.stringify(page, null, 2) }],
+        };
+    });
+    server.tool("pages_delete", "Delete a Ghost page", deleteParams, async (args, _extra) => {
+        await ghostApi_1.ghostApiClient.pages.delete(args);
+        return {
+            content: [{ type: "text", text: `Page with id ${args.id} deleted.` }],
+        };
+    });
+}

package/build/tools/redirects.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRedirectsAndRoutesTools = registerRedirectsAndRoutesTools;
+// src/tools/redirects.ts
+const zod_1 = require("zod");
+const ghostHttp_1 = require("../utils/ghostHttp");
+function registerRedirectsAndRoutesTools(server) {
+    server.tool("redirects_download", "Download current Ghost redirects configuration (JSON/YAML)", {}, async (_args, _extra) => {
+        const data = await (0, ghostHttp_1.ghostGet)("redirects/download/");
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("redirects_upload", "Upload a redirects.yaml or redirects.json file to Ghost", { file: zod_1.z.string().describe("Absolute local file path or URL to the redirects file") }, async (args, _extra) => {
+        const result = await (0, ghostHttp_1.ghostUploadFile)("redirects/upload/", args.file);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("routes_upload", "Upload a routes.yaml file to Ghost", { file: zod_1.z.string().describe("Absolute local file path or URL to the routes.yaml file") }, async (args, _extra) => {
+        const result = await (0, ghostHttp_1.ghostUploadFile)("settings/routes/yaml/", args.file);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}

package/build/tools/settings.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSettingsTools = registerSettingsTools;
+// src/tools/settings.ts
+const zod_1 = require("zod");
+const ghostHttp_1 = require("../utils/ghostHttp");
+const navigationItem = zod_1.z.object({
+    label: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+const editParams = {
+    title: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    logo: zod_1.z.string().optional(),
+    icon: zod_1.z.string().optional(),
+    cover_image: zod_1.z.string().optional(),
+    accent_color: zod_1.z.string().optional(),
+    locale: zod_1.z.string().optional(),
+    timezone: zod_1.z.string().optional(),
+    codeinjection_head: zod_1.z.string().optional(),
+    codeinjection_foot: zod_1.z.string().optional(),
+    facebook: zod_1.z.string().optional(),
+    twitter: zod_1.z.string().optional(),
+    navigation: zod_1.z.array(navigationItem).optional(),
+    secondary_navigation: zod_1.z.array(navigationItem).optional(),
+    meta_title: zod_1.z.string().optional(),
+    meta_description: zod_1.z.string().optional(),
+    og_image: zod_1.z.string().optional(),
+    og_title: zod_1.z.string().optional(),
+    og_description: zod_1.z.string().optional(),
+    twitter_image: zod_1.z.string().optional(),
+    twitter_title: zod_1.z.string().optional(),
+    twitter_description: zod_1.z.string().optional(),
+    posts_per_page: zod_1.z.number().optional(),
+    members_support_address: zod_1.z.string().optional(),
+};
+function registerSettingsTools(server) {
+    server.tool("settings_read", "Read all Ghost site settings (SEO, branding, code injection, navigation, social, etc.)", {}, async (_args, _extra) => {
+        const data = await (0, ghostHttp_1.ghostGet)("settings/");
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("settings_edit", "Edit Ghost site settings (title, description, logo, icon, meta, OG, code injection, navigation, etc.)", editParams, async (args, _extra) => {
+        // Ghost settings API expects { settings: [{ key, value }, ...] }
+        const settings = Object.entries(args)
+            .filter(([_, v]) => v !== undefined)
+            .map(([key, value]) => ({ key, value }));
+        const data = await (0, ghostHttp_1.ghostPut)("settings/", { settings });
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+}

package/build/tools/site.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSiteTools = registerSiteTools;
+const ghostApi_1 = require("../ghostApi");
+function registerSiteTools(server) {
+    server.tool("site_read", "Read site basic info (title, description, logo, url, version, etc.)", {}, async (_args, _extra) => {
+        const site = await ghostApi_1.ghostApiClient.site.read();
+        return {
+            content: [{ type: "text", text: JSON.stringify(site, null, 2) }],
+        };
+    });
+}

package/build/tools/themes.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerThemeTools = registerThemeTools;
+// src/tools/themes.ts
+const zod_1 = require("zod");
+const ghostApi_1 = require("../ghostApi");
+const ghostHttp_1 = require("../utils/ghostHttp");
+const fs_1 = __importDefault(require("fs"));
+function registerThemeTools(server) {
+    server.tool("themes_browse", "List all installed Ghost themes", {}, async (_args, _extra) => {
+        const data = await (0, ghostHttp_1.ghostGet)("themes/");
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("themes_upload", "Upload a Ghost theme zip file", { file: zod_1.z.string().describe("Absolute local file path or URL to the theme zip file") }, async (args, _extra) => {
+        const { filePath, isTemp } = await (0, ghostHttp_1.resolveFileInput)(args.file);
+        try {
+            const result = await ghostApi_1.ghostApiClient.themes.upload({ ...args, file: filePath });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        finally {
+            if (isTemp)
+                fs_1.default.unlinkSync(filePath);
+        }
+    });
+    server.tool("themes_activate", "Activate an installed Ghost theme by name", { name: zod_1.z.string().describe("Theme name to activate") }, async (args, _extra) => {
+        const result = await ghostApi_1.ghostApiClient.themes.activate(args.name);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("themes_download", "Download a Ghost theme as zip. Returns the saved file path.", {
+        name: zod_1.z.string().describe("Theme name to download"),
+        output_path: zod_1.z.string().describe("Absolute path to save the downloaded zip"),
+    }, async (args, _extra) => {
+        const data = await (0, ghostHttp_1.ghostDownload)(`themes/${args.name}/download/`);
+        fs_1.default.writeFileSync(args.output_path, data);
+        return {
+            content: [{ type: "text", text: `Theme saved to ${args.output_path}` }],
+        };
+    });
+}

package/build/tools/upload.js

@@ -1,58 +1,124 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerUploadTools = registerUploadTools;
 // src/tools/upload.ts
 const zod_1 = require("zod");
 const ghostApi_1 = require("../ghostApi");
+const ghostHttp_1 = require("../utils/ghostHttp");
+const fs = __importStar(require("fs"));
 const imageUploadParams = {
-    file: zod_1.z.string().describe("Absolute path to the image file"),
+    file: zod_1.z.string().describe("Absolute local file path or URL to the image"),
     purpose: zod_1.z.string().optional().describe("Purpose of the image (default: 'image')"),
     ref: zod_1.z.string().optional().describe("Reference string returned in the response"),
 };
 const mediaUploadParams = {
-    file: zod_1.z.string().describe("Absolute path to the audio/video file"),
-    thumbnail: zod_1.z.string().optional().describe("Absolute path to a thumbnail image for the media"),
+    file: zod_1.z.string().describe("Absolute local file path or URL to the audio/video file"),
+    thumbnail: zod_1.z.string().optional().describe("Absolute local file path or URL to a thumbnail image"),
     purpose: zod_1.z.string().optional().describe("Purpose of the media"),
 };
 const fileUploadParams = {
-    file: zod_1.z.string().describe("Absolute path to the file"),
+    file: zod_1.z.string().describe("Absolute local file path or URL to the file"),
     ref: zod_1.z.string().optional().describe("Reference string returned in the response"),
 };
 function registerUploadTools(server) {
     // Upload image
     server.tool("images_upload", "Upload an image to Ghost (jpg, jpeg, png, gif, svg, svgz, ico, webp). Returns the CDN URL.", imageUploadParams, async (args, _extra) => {
-        const result = await ghostApi_1.ghostApiClient.images.upload(args);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
+        const { filePath, isTemp } = await (0, ghostHttp_1.resolveFileInput)(args.file);
+        try {
+            const result = await ghostApi_1.ghostApiClient.images.upload({ ...args, file: filePath });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        finally {
+            if (isTemp)
+                fs.unlinkSync(filePath);
+        }
     });
     // Upload media (audio/video)
     server.tool("media_upload", "Upload audio/video to Ghost (mp4, webm, ogv, mp3, wav, ogg, m4a). Returns the CDN URL.", mediaUploadParams, async (args, _extra) => {
-        const result = await ghostApi_1.ghostApiClient.media.upload(args);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
+        const { filePath, isTemp } = await (0, ghostHttp_1.resolveFileInput)(args.file);
+        let thumbnailResolved = null;
+        if (args.thumbnail) {
+            thumbnailResolved = await (0, ghostHttp_1.resolveFileInput)(args.thumbnail);
+        }
+        try {
+            const result = await ghostApi_1.ghostApiClient.media.upload({
+                ...args,
+                file: filePath,
+                ...(thumbnailResolved ? { thumbnail: thumbnailResolved.filePath } : {}),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        finally {
+            if (isTemp)
+                fs.unlinkSync(filePath);
+            if (thumbnailResolved?.isTemp)
+                fs.unlinkSync(thumbnailResolved.filePath);
+        }
     });
     // Upload file
     server.tool("files_upload", "Upload a file to Ghost (pdf, docx, xlsx, csv, epub, zip, etc. 50+ formats). Returns the CDN URL.", fileUploadParams, async (args, _extra) => {
-        const result = await ghostApi_1.ghostApiClient.files.upload(args);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
+        const { filePath, isTemp } = await (0, ghostHttp_1.resolveFileInput)(args.file);
+        try {
+            const result = await ghostApi_1.ghostApiClient.files.upload({ ...args, file: filePath });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        finally {
+            if (isTemp)
+                fs.unlinkSync(filePath);
+        }
     });
 }

package/build/utils/ghostHttp.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFileInput = resolveFileInput;
+exports.ghostGet = ghostGet;
+exports.ghostPut = ghostPut;
+exports.ghostPost = ghostPost;
+exports.ghostUploadFile = ghostUploadFile;
+exports.ghostDownload = ghostDownload;
+// src/utils/ghostHttp.ts
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const axios_1 = __importDefault(require("axios"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const config_1 = require("../config");
+/**
+ * If input is a URL, download to a temp file and return the path.
+ * If input is a local path, return as-is.
+ */
+async function resolveFileInput(input) {
+    if (!input.startsWith("http://") && !input.startsWith("https://")) {
+        return { filePath: input, isTemp: false };
+    }
+    const urlPath = new URL(input).pathname;
+    const ext = path_1.default.extname(urlPath) || ".tmp";
+    const tempFile = path_1.default.join(os_1.default.tmpdir(), `ghost-mcp-${Date.now()}${ext}`);
+    const response = await axios_1.default.get(input, { responseType: "stream" });
+    const writer = fs_1.default.createWriteStream(tempFile);
+    response.data.pipe(writer);
+    await new Promise((resolve, reject) => {
+        writer.on("finish", resolve);
+        writer.on("error", reject);
+    });
+    return { filePath: tempFile, isTemp: true };
+}
+function generateToken() {
+    const [id, secret] = config_1.GHOST_ADMIN_API_KEY.split(":");
+    return jsonwebtoken_1.default.sign({}, Buffer.from(secret, "hex"), {
+        keyid: id,
+        algorithm: "HS256",
+        expiresIn: "5m",
+        audience: `/${config_1.GHOST_API_VERSION}/admin/`,
+    });
+}
+function apiUrl(endpoint) {
+    return `${config_1.GHOST_API_URL.replace(/\/+$/, "")}/ghost/api/admin/${endpoint.replace(/^\/+/, "")}`;
+}
+function authHeaders() {
+    return { Authorization: `Ghost ${generateToken()}` };
+}
+async function ghostGet(endpoint, params) {
+    const res = await axios_1.default.get(apiUrl(endpoint), {
+        headers: authHeaders(),
+        params,
+    });
+    return res.data;
+}
+async function ghostPut(endpoint, data) {
+    const res = await axios_1.default.put(apiUrl(endpoint), data, {
+        headers: { ...authHeaders(), "Content-Type": "application/json" },
+    });
+    return res.data;
+}
+async function ghostPost(endpoint, data) {
+    const res = await axios_1.default.post(apiUrl(endpoint), data, {
+        headers: { ...authHeaders(), "Content-Type": "application/json" },
+    });
+    return res.data;
+}
+async function ghostUploadFile(endpoint, filePath, fieldName = "file") {
+    const { filePath: resolvedPath, isTemp } = await resolveFileInput(filePath);
+    try {
+        const FormData = (await import("form-data")).default;
+        const form = new FormData();
+        form.append(fieldName, fs_1.default.createReadStream(resolvedPath));
+        const res = await axios_1.default.post(apiUrl(endpoint), form, {
+            headers: {
+                ...authHeaders(),
+                ...form.getHeaders(),
+            },
+        });
+        return res.data;
+    }
+    finally {
+        if (isTemp)
+            fs_1.default.unlinkSync(resolvedPath);
+    }
+}
+async function ghostDownload(endpoint) {
+    const res = await axios_1.default.get(apiUrl(endpoint), {
+        headers: authHeaders(),
+        responseType: "arraybuffer",
+    });
+    return res.data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@junis/ghost-mcp",
-    "version": "0.2.1",
+    "version": "0.4.0",
     "description": "MCP server for using the Ghost API",
     "main": "build/server.js",
     "bin": {
@@ -26,10 +26,12 @@
         "@modelcontextprotocol/sdk": "^1.10.1",
         "@tryghost/admin-api": "^1.13.13",
         "axios": "^1.8.4",
+        "jsonwebtoken": "^9.0.3",
         "zod": "^3.24.3"
     },
     "devDependencies": {
         "@types/axios": "^0.9.36",
+        "@types/jsonwebtoken": "^9.0.10",
         "@types/node": "^22.14.1",
         "typescript": "^5.8.3"
     }