mcp-ghost-optimized 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthieu Cousin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# MCP Ghost Optimized
+
+Serveur MCP pour Ghost CMS avec **field projection** pour réduire la consommation de tokens de 90-98%.
+
+## Pourquoi ce MCP ?
+
+Le MCP officiel `@fanyangmeng/ghost-mcp` retourne ~14K tokens par appel. Ce MCP optimisé retourne ~200-1500 tokens selon le mode choisi.
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Configuration
+
+Ajouter dans `.mcp.json` :
+
+```json
+{
+  "mcpServers": {
+    "ghost-optimized": {
+      "command": "node",
+      "args": ["/chemin/vers/mcp-ghost-perso/dist/index.js"],
+      "env": {
+        "GHOST_URL": "https://votre-blog.ghost.io",
+        "GHOST_ADMIN_API_KEY": "id:secret",
+        "GHOST_DEFAULT_TEMPLATE": "custom-template-perso"
+      }
+    }
+  }
+}
+```
+
+### Variables d'environnement
+
+| Variable | Obligatoire | Description |
+|----------|-------------|-------------|
+| `GHOST_URL` | Oui | URL de votre blog Ghost |
+| `GHOST_ADMIN_API_KEY` | Oui | Clé API Admin (format `id:secret`) |
+| `GHOST_DEFAULT_TEMPLATE` | Non | Template par défaut pour les nouveaux posts |
+
+## Tools disponibles
+
+### Posts
+
+| Tool | Description |
+|------|-------------|
+| `posts_browse` | Liste les posts avec modes `minimal`, `compact`, `standard` |
+| `posts_read` | Lit un post avec modes `metadata`, `content`, `full` |
+| `posts_add` | Crée un post (supporte HTML via `?source=html`) |
+| `posts_edit` | Modifie un post (gère auto `updated_at`) |
+| `posts_delete` | Supprime un post (requiert `confirm: true` + `title`) |
+
+### Tags
+
+| Tool | Description |
+|------|-------------|
+| `tags_browse` | Liste les tags avec modes `minimal`, `standard` |
+| `tags_read` | Lit un tag par ID ou slug |
+
+### Images
+
+| Tool | Description |
+|------|-------------|
+| `images_upload` | Upload une image depuis `file_path` ou `url` |
+
+## Exemples d'utilisation
+
+### Lister les posts publiés
+
+```
+posts_browse(status: "published", mode: "compact", limit: 10)
+```
+
+### Filtrer par tag (NQL)
+
+```
+posts_browse(filter: "tag:finance+status:published")
+```
+
+### Créer un post avec HTML
+
+```
+posts_add(
+  title: "Mon article",
+  html: "<p>Contenu de l'article</p>",
+  status: "draft",
+  tags: ["tech", "tutorial"]
+)
+```
+
+### Uploader une image
+
+```
+# Depuis un fichier local
+images_upload(file_path: "/tmp/image.jpg")
+
+# Depuis une URL
+images_upload(url: "https://example.com/image.jpg", filename: "image.jpg")
+```
+
+### Supprimer un post
+
+```
+posts_delete(id: "xxx", title: "Titre du post", confirm: true)
+```
+
+## Modes de réponse
+
+### posts_browse
+
+| Mode | Tokens/post | Champs |
+|------|-------------|--------|
+| `minimal` | ~15 | id, title, slug, status |
+| `compact` | ~50 | + published_at, updated_at |
+| `standard` | ~150 | + tags, excerpt, reading_time |
+
+### posts_read
+
+| Mode | Tokens | Champs |
+|------|--------|--------|
+| `metadata` | ~200 | Métadonnées sans contenu |
+| `content` | ~500-2000 | + plaintext (HTML converti) |
+| `full` | ~500-3000 | + HTML brut |
+
+## Développement
+
+```bash
+npm run dev    # Watch mode
+npm run build  # Compile TypeScript
+```
+
+## Structure
+
+```
+src/
+├── index.ts          # Entry point (stdio transport)
+├── server.ts         # Définition des tools MCP
+├── api/
+│   ├── auth.ts       # Génération JWT
+│   └── client.ts     # Client HTTP avec field projection
+└── utils/
+    ├── fields.ts     # Presets de champs par mode
+    └── html.ts       # Conversion HTML → plaintext
+```
+
+## Licence
+
+MIT

package/dist/api/auth.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ghost Admin API JWT Authentication
+ *
+ * Ghost uses short-lived JWT tokens for Admin API authentication.
+ * Tokens are signed with HS256 using the secret portion of the API key.
+ *
+ * API Key format: {key_id}:{secret}
+ * - key_id: Identifies which key is being used
+ * - secret: Hex-encoded secret for signing
+ */
+/**
+ * Generate a JWT token for Ghost Admin API authentication
+ *
+ * @param apiKey - Ghost Admin API key in format "id:secret"
+ * @returns Signed JWT token
+ * @throws Error if apiKey format is invalid
+ */
+export declare function generateJWT(apiKey: string): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/api/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+ClD"}

package/dist/api/auth.js

@@ -0,0 +1,67 @@
+/**
+ * Ghost Admin API JWT Authentication
+ *
+ * Ghost uses short-lived JWT tokens for Admin API authentication.
+ * Tokens are signed with HS256 using the secret portion of the API key.
+ *
+ * API Key format: {key_id}:{secret}
+ * - key_id: Identifies which key is being used
+ * - secret: Hex-encoded secret for signing
+ */
+import * as crypto from "crypto";
+/**
+ * Generate a JWT token for Ghost Admin API authentication
+ *
+ * @param apiKey - Ghost Admin API key in format "id:secret"
+ * @returns Signed JWT token
+ * @throws Error if apiKey format is invalid
+ */
+export function generateJWT(apiKey) {
+    const parts = apiKey.split(":");
+    if (parts.length !== 2) {
+        throw new Error('Invalid API key format. Expected "id:secret" but got: ' +
+            (parts.length === 1
+                ? "single value (missing colon)"
+                : `${parts.length} parts`));
+    }
+    const [keyId, keySecret] = parts;
+    if (!keyId || !keySecret) {
+        throw new Error("API key id or secret is empty");
+    }
+    // Header
+    const header = {
+        alg: "HS256",
+        typ: "JWT",
+        kid: keyId,
+    };
+    // Payload - 5 minute expiry is recommended by Ghost
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        iat: now,
+        exp: now + 300, // 5 minutes
+        aud: "/admin/",
+    };
+    // Encode header and payload
+    const encodedHeader = base64url(JSON.stringify(header));
+    const encodedPayload = base64url(JSON.stringify(payload));
+    const signatureInput = `${encodedHeader}.${encodedPayload}`;
+    // Sign with HMAC-SHA256
+    const secret = Buffer.from(keySecret, "hex");
+    const signature = crypto
+        .createHmac("sha256", secret)
+        .update(signatureInput)
+        .digest();
+    const encodedSignature = base64url(signature);
+    return `${signatureInput}.${encodedSignature}`;
+}
+/**
+ * Base64URL encode (RFC 4648)
+ * Removes padding and replaces + with - and / with _
+ */
+function base64url(input) {
+    const base64 = Buffer.isBuffer(input)
+        ? input.toString("base64")
+        : Buffer.from(input).toString("base64");
+    return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBACjB,CAAC,CAAC,8BAA8B;gBAChC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;IAEjC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,SAAS;IACT,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;KACX,CAAC;IAEF,oDAAoD;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,YAAY;QAC5B,GAAG,EAAE,SAAS;KACf,CAAC;IAEF,4BAA4B;IAC5B,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,GAAG,aAAa,IAAI,cAAc,EAAE,CAAC;IAE5D,wBAAwB;IACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM;SACrB,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC5B,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,EAAE,CAAC;IACZ,MAAM,gBAAgB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO,GAAG,cAAc,IAAI,gBAAgB,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAsB;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/api/client.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Ghost Admin API Client with Field Projection
+ *
+ * This custom client bypasses @tryghost/admin-api to use the `fields` parameter
+ * that the official library doesn't expose, enabling significant token reduction.
+ */
+export interface GhostClientConfig {
+    /** Ghost site URL (e.g., https://your-blog.ghost.io) */
+    url: string;
+    /** Admin API key in format "id:secret" */
+    apiKey: string;
+}
+export interface BrowseOptions {
+    /** Fields to return (projection) */
+    fields?: string[];
+    /** NQL filter string */
+    filter?: string;
+    /** Number of results per page */
+    limit?: number;
+    /** Page number */
+    page?: number;
+    /** Sort order (e.g., "published_at desc") */
+    order?: string;
+    /** Relations to include */
+    include?: string[];
+}
+export interface ReadOptions {
+    /** Fields to return (projection) */
+    fields?: string[];
+    /** Relations to include */
+    include?: string[];
+    /** Formats to include (html, plaintext, mobiledoc) */
+    formats?: string[];
+}
+export declare class GhostClient {
+    private config;
+    private baseUrl;
+    constructor(config: GhostClientConfig);
+    /**
+     * Get authorization headers with fresh JWT token
+     */
+    private getHeaders;
+    /**
+     * Handle API errors
+     */
+    private handleResponse;
+    /**
+     * Browse resources with field projection
+     *
+     * @param resource - Resource type (posts, tags, members, etc.)
+     * @param options - Query options including field projection
+     */
+    browse<T>(resource: string, options?: BrowseOptions): Promise<T>;
+    /**
+     * Read a single resource by ID or slug
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID or "slug/{slug}" for slug lookup
+     * @param options - Query options including field projection
+     */
+    read<T>(resource: string, id: string, options?: ReadOptions): Promise<T>;
+    /**
+     * Create a new resource
+     *
+     * @param resource - Resource type
+     * @param data - Resource data
+     */
+    add<T>(resource: string, data: Record<string, unknown>): Promise<T>;
+    /**
+     * Update an existing resource
+     *
+     * This method automatically fetches the current `updated_at` timestamp
+     * to handle Ghost's optimistic locking, so you don't need to provide it.
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID
+     * @param data - Fields to update
+     */
+    edit<T>(resource: string, id: string, data: Record<string, unknown>): Promise<T>;
+    /**
+     * Delete a resource
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID
+     */
+    delete(resource: string, id: string): Promise<void>;
+    /**
+     * Upload an image to Ghost from a Buffer
+     *
+     * @param buffer - Image data as Buffer
+     * @param filename - Filename with extension (e.g., "cover.jpg")
+     * @returns URL of the uploaded image
+     */
+    uploadImageFromBuffer(buffer: Buffer, filename: string): Promise<string>;
+    /**
+     * Upload an image to Ghost from a local file path
+     *
+     * @param filePath - Absolute path to the image file
+     * @returns URL of the uploaded image
+     */
+    uploadImageFromPath(filePath: string): Promise<string>;
+    /**
+     * Upload an image to Ghost from a URL
+     *
+     * @param imageUrl - URL of the image to download and upload
+     * @param filename - Filename with extension
+     * @returns URL of the uploaded image
+     */
+    uploadImageFromUrl(imageUrl: string, filename: string): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,iBAAiB;IAMrC;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;YACW,cAAc;IAuB5B;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAgC1E;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EACV,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC;IAuBb;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAczE;;;;;;;;;OASG;IACG,IAAI,CAAC,CAAC,EACV,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;IAiCb;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD;;;;;;OAMG;IACG,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IA+ElB;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5D;;;;;;OAMG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;CAQnB"}

package/dist/api/client.js

@@ -0,0 +1,262 @@
+/**
+ * Ghost Admin API Client with Field Projection
+ *
+ * This custom client bypasses @tryghost/admin-api to use the `fields` parameter
+ * that the official library doesn't expose, enabling significant token reduction.
+ */
+import { generateJWT } from "./auth.js";
+import * as fs from "fs/promises";
+import * as path from "path";
+export class GhostClient {
+    config;
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        // Remove trailing slash if present
+        this.baseUrl = config.url.replace(/\/$/, "");
+    }
+    /**
+     * Get authorization headers with fresh JWT token
+     */
+    getHeaders() {
+        return {
+            Authorization: `Ghost ${generateJWT(this.config.apiKey)}`,
+            "Content-Type": "application/json",
+            "Accept-Version": "v5.0",
+        };
+    }
+    /**
+     * Handle API errors
+     */
+    async handleResponse(response) {
+        if (!response.ok) {
+            let errorMessage = `Ghost API error: ${response.status} ${response.statusText}`;
+            try {
+                const errorBody = (await response.json());
+                if (errorBody.errors?.[0]) {
+                    const err = errorBody.errors[0];
+                    errorMessage = `Ghost API error: ${err.message}`;
+                    if (err.context) {
+                        errorMessage += ` (${err.context})`;
+                    }
+                }
+            }
+            catch {
+                // Ignore JSON parse errors, use default message
+            }
+            throw new Error(errorMessage);
+        }
+        return response.json();
+    }
+    /**
+     * Browse resources with field projection
+     *
+     * @param resource - Resource type (posts, tags, members, etc.)
+     * @param options - Query options including field projection
+     */
+    async browse(resource, options = {}) {
+        const params = new URLSearchParams();
+        if (options.fields?.length) {
+            params.set("fields", options.fields.join(","));
+        }
+        if (options.filter) {
+            params.set("filter", options.filter);
+        }
+        if (options.limit !== undefined) {
+            params.set("limit", options.limit.toString());
+        }
+        if (options.page !== undefined) {
+            params.set("page", options.page.toString());
+        }
+        if (options.order) {
+            params.set("order", options.order);
+        }
+        if (options.include?.length) {
+            params.set("include", options.include.join(","));
+        }
+        const url = `${this.baseUrl}/ghost/api/admin/${resource}/?${params}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Read a single resource by ID or slug
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID or "slug/{slug}" for slug lookup
+     * @param options - Query options including field projection
+     */
+    async read(resource, id, options = {}) {
+        const params = new URLSearchParams();
+        if (options.fields?.length) {
+            params.set("fields", options.fields.join(","));
+        }
+        if (options.include?.length) {
+            params.set("include", options.include.join(","));
+        }
+        if (options.formats?.length) {
+            params.set("formats", options.formats.join(","));
+        }
+        const url = `${this.baseUrl}/ghost/api/admin/${resource}/${id}/?${params}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Create a new resource
+     *
+     * @param resource - Resource type
+     * @param data - Resource data
+     */
+    async add(resource, data) {
+        // Add ?source=html when creating posts with HTML content
+        const sourceParam = resource === "posts" && data.html ? "?source=html" : "";
+        const url = `${this.baseUrl}/ghost/api/admin/${resource}/${sourceParam}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify({ [resource]: [data] }),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Update an existing resource
+     *
+     * This method automatically fetches the current `updated_at` timestamp
+     * to handle Ghost's optimistic locking, so you don't need to provide it.
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID
+     * @param data - Fields to update
+     */
+    async edit(resource, id, data) {
+        const current = await this.read(resource, id, { fields: ["updated_at"] });
+        const resourceArray = current[resource];
+        if (!resourceArray?.[0]?.updated_at) {
+            throw new Error(`Could not fetch updated_at for ${resource}/${id}`);
+        }
+        const updated_at = resourceArray[0].updated_at;
+        // Add ?source=html when editing posts with HTML content
+        const sourceParam = resource === "posts" && data.html ? "?source=html" : "";
+        const url = `${this.baseUrl}/ghost/api/admin/${resource}/${id}/${sourceParam}`;
+        const response = await fetch(url, {
+            method: "PUT",
+            headers: this.getHeaders(),
+            body: JSON.stringify({
+                [resource]: [{ ...data, updated_at }],
+            }),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Delete a resource
+     *
+     * @param resource - Resource type
+     * @param id - Resource ID
+     */
+    async delete(resource, id) {
+        const url = `${this.baseUrl}/ghost/api/admin/${resource}/${id}/`;
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            await this.handleResponse(response);
+        }
+    }
+    /**
+     * Upload an image to Ghost from a Buffer
+     *
+     * @param buffer - Image data as Buffer
+     * @param filename - Filename with extension (e.g., "cover.jpg")
+     * @returns URL of the uploaded image
+     */
+    async uploadImageFromBuffer(buffer, filename) {
+        // Determine MIME type from extension
+        const ext = filename.split(".").pop()?.toLowerCase() || "png";
+        const mimeTypes = {
+            jpg: "image/jpeg",
+            jpeg: "image/jpeg",
+            png: "image/png",
+            gif: "image/gif",
+            webp: "image/webp",
+            svg: "image/svg+xml",
+        };
+        const mimeType = mimeTypes[ext] || "application/octet-stream";
+        // Build multipart/form-data manually
+        const boundary = `----GhostMCPBoundary${Date.now()}`;
+        const parts = [];
+        // File part
+        parts.push(Buffer.from(`--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="file"; filename="${filename}"\r\n` +
+            `Content-Type: ${mimeType}\r\n\r\n`));
+        parts.push(buffer);
+        parts.push(Buffer.from("\r\n"));
+        // Purpose part (required by Ghost)
+        parts.push(Buffer.from(`--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="purpose"\r\n\r\n` +
+            `image\r\n`));
+        // Closing boundary
+        parts.push(Buffer.from(`--${boundary}--\r\n`));
+        const body = Buffer.concat(parts);
+        const url = `${this.baseUrl}/ghost/api/admin/images/upload/`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Ghost ${generateJWT(this.config.apiKey)}`,
+                "Content-Type": `multipart/form-data; boundary=${boundary}`,
+                "Accept-Version": "v5.0",
+            },
+            body,
+        });
+        if (!response.ok) {
+            let errorMessage = `Ghost API error: ${response.status}`;
+            try {
+                const errorBody = (await response.json());
+                if (errorBody.errors?.[0]?.message) {
+                    errorMessage = `Ghost API error: ${errorBody.errors[0].message}`;
+                }
+            }
+            catch {
+                // Ignore
+            }
+            throw new Error(errorMessage);
+        }
+        const result = (await response.json());
+        if (!result.images?.[0]?.url) {
+            throw new Error("Upload succeeded but no URL returned");
+        }
+        return result.images[0].url;
+    }
+    /**
+     * Upload an image to Ghost from a local file path
+     *
+     * @param filePath - Absolute path to the image file
+     * @returns URL of the uploaded image
+     */
+    async uploadImageFromPath(filePath) {
+        const buffer = await fs.readFile(filePath);
+        const filename = path.basename(filePath);
+        return this.uploadImageFromBuffer(buffer, filename);
+    }
+    /**
+     * Upload an image to Ghost from a URL
+     *
+     * @param imageUrl - URL of the image to download and upload
+     * @param filename - Filename with extension
+     * @returns URL of the uploaded image
+     */
+    async uploadImageFromUrl(imageUrl, filename) {
+        const response = await fetch(imageUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to download image: ${response.status}`);
+        }
+        const buffer = Buffer.from(await response.arrayBuffer());
+        return this.uploadImageFromBuffer(buffer, filename);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * MCP Ghost Optimized - Entry Point
+ *
+ * This MCP server provides Ghost Admin API tools with field projection
+ * for significant token reduction compared to standard Ghost MCP.
+ *
+ * Environment variables required:
+ * - GHOST_URL: Ghost site URL (e.g., https://your-blog.ghost.io)
+ * - GHOST_ADMIN_API_KEY: Admin API key in format "id:secret"
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}