@junis/ghost-mcp 0.2.0 → 0.3.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/posts.js

@@ -29,6 +29,12 @@ const addParams = {
     feature_image: zod_1.z.string().optional(),
     og_title: zod_1.z.string().optional(),
     og_description: zod_1.z.string().optional(),
+    og_image: zod_1.z.string().optional(),
+    twitter_title: zod_1.z.string().optional(),
+    twitter_description: zod_1.z.string().optional(),
+    twitter_image: zod_1.z.string().optional(),
+    feature_image_alt: zod_1.z.string().optional(),
+    feature_image_caption: zod_1.z.string().optional(),
     custom_excerpt: zod_1.z.string().optional(),
 };
 const editParams = {
@@ -47,6 +53,12 @@ const editParams = {
     feature_image: zod_1.z.string().optional(),
     og_title: zod_1.z.string().optional(),
     og_description: zod_1.z.string().optional(),
+    og_image: zod_1.z.string().optional(),
+    twitter_title: zod_1.z.string().optional(),
+    twitter_description: zod_1.z.string().optional(),
+    twitter_image: zod_1.z.string().optional(),
+    feature_image_alt: zod_1.z.string().optional(),
+    feature_image_caption: zod_1.z.string().optional(),
     custom_excerpt: zod_1.z.string().optional(),
 };
 const deleteParams = {

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 path 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 path 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,41 @@
+"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 path to the theme zip file") }, async (args, _extra) => {
+        const result = await ghostApi_1.ghostApiClient.themes.upload(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    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/utils/ghostHttp.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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 config_1 = require("../config");
+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 FormData = (await import("form-data")).default;
+    const form = new FormData();
+    form.append(fieldName, fs_1.default.createReadStream(filePath));
+    const res = await axios_1.default.post(apiUrl(endpoint), form, {
+        headers: {
+            ...authHeaders(),
+            ...form.getHeaders(),
+        },
+    });
+    return res.data;
+}
+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.0",
+    "version": "0.3.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"
     }