@kieksme/mcp-hashnode 1.1.0

package/dist/tools/publications.js

@@ -0,0 +1,183 @@
+import { z } from "zod";
+import { gql } from "../services/hashnode.js";
+var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+const ResponseFormatSchema = z
+    .nativeEnum(ResponseFormat)
+    .default(ResponseFormat.MARKDOWN)
+    .describe("Output format: 'markdown' (default) or 'json'");
+// ─── Queries ──────────────────────────────────────────────────────────────────
+const ME_QUERY = `
+  query {
+    me {
+      id
+      name
+      username
+      profilePicture
+      publications(first: 20) {
+        edges {
+          node {
+            id
+            title
+            displayTitle
+            url
+          }
+        }
+      }
+    }
+  }
+`;
+const PUBLICATION_QUERY = `
+  query ($host: String!) {
+    publication(host: $host) {
+      id
+      title
+      displayTitle
+      url
+      about { text }
+      author { name username }
+    }
+  }
+`;
+// ─── Register ─────────────────────────────────────────────────────────────────
+export function registerPublicationTools(server) {
+    // hashnode_get_me ──────────────────────────────────────────────────────────
+    server.registerTool("hashnode_get_me", {
+        title: "Get current Hashnode user and their publications",
+        description: `Returns the authenticated user's profile and a list of their publications.
+Use this first to discover your publicationId(s) before creating or listing posts.
+
+Returns:
+  - id, name, username, profilePicture
+  - publications[]: { id, title, url }
+
+Examples:
+  - "What is my publication ID?" → call hashnode_get_me
+  - "List my Hashnode blogs" → call hashnode_get_me`,
+        inputSchema: {
+            response_format: ResponseFormatSchema,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ response_format }) => {
+        try {
+            const data = await gql(ME_QUERY);
+            const me = data.me;
+            const publications = (me.publications?.edges ?? []).map((e) => e.node);
+            if (response_format === ResponseFormat.JSON) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ ...me, publications }, null, 2),
+                        },
+                    ],
+                    structuredContent: { ...me, publications },
+                };
+            }
+            const lines = [
+                `# Hashnode User: ${me.name} (@${me.username})`,
+                `**ID**: ${me.id}`,
+                "",
+                "## Publications",
+            ];
+            if (publications.length === 0) {
+                lines.push("_No publications found._");
+            }
+            else {
+                for (const p of publications) {
+                    lines.push(`- **${p.title}** — ID: \`${p.id}\` — ${p.url}`);
+                }
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: error instanceof Error ? error.message : String(error),
+                    },
+                ],
+            };
+        }
+    });
+    // hashnode_get_publication ─────────────────────────────────────────────────
+    server.registerTool("hashnode_get_publication", {
+        title: "Get Hashnode publication by host",
+        description: `Fetch metadata for a Hashnode publication by its host/domain.
+
+Args:
+  - host (string): Publication host, e.g. "yourblog.hashnode.dev" or a custom domain
+  - response_format: 'markdown' or 'json'
+
+Returns: id, title, url, about, author info
+
+Examples:
+  - host: "thinkport.hashnode.dev"`,
+        inputSchema: {
+            host: z
+                .string()
+                .min(1)
+                .describe("Publication host, e.g. 'yourblog.hashnode.dev' or a custom domain"),
+            response_format: ResponseFormatSchema,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ host, response_format }) => {
+        try {
+            const data = await gql(PUBLICATION_QUERY, { host });
+            const pub = data.publication;
+            if (!pub) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: No publication found for host '${host}'.`,
+                        },
+                    ],
+                };
+            }
+            if (response_format === ResponseFormat.JSON) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify(pub, null, 2) }],
+                    structuredContent: pub,
+                };
+            }
+            const lines = [
+                `# ${pub.displayTitle ?? pub.title}`,
+                `**ID**: \`${pub.id}\``,
+                `**URL**: ${pub.url}`,
+            ];
+            if (pub.author) {
+                lines.push(`**Author**: ${pub.author.name} (@${pub.author.username})`);
+            }
+            if (pub.about?.text) {
+                lines.push("", String(pub.about.text));
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: error instanceof Error ? error.message : String(error),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=publications.js.map

package/dist/tools/publications.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+export interface HashnodeTag {
+    [key: string]: unknown;
+    name: string;
+    slug: string;
+    id?: string;
+}
+export interface HashnodePost {
+    [key: string]: unknown;
+    id: string;
+    title: string;
+    subtitle?: string;
+    slug: string;
+    url: string;
+    brief?: string;
+    publishedAt?: string;
+    updatedAt?: string;
+    readTimeInMinutes?: number;
+    views?: number;
+    tags?: HashnodeTag[];
+    coverImage?: {
+        url: string;
+        [key: string]: unknown;
+    };
+    author?: {
+        name: string;
+        username: string;
+        [key: string]: unknown;
+    };
+    publication?: {
+        id: string;
+        title: string;
+        url: string;
+        [key: string]: unknown;
+    };
+}
+export interface HashnodeDraft {
+    [key: string]: unknown;
+    id: string;
+    title?: string;
+    subtitle?: string;
+    slug?: string;
+    contentMarkdown?: string;
+    tags?: HashnodeTag[];
+    coverImage?: {
+        url: string;
+        [key: string]: unknown;
+    };
+    updatedAt?: string;
+    author?: {
+        name: string;
+        username: string;
+        [key: string]: unknown;
+    };
+}
+export interface HashnodePublication {
+    [key: string]: unknown;
+    id: string;
+    title: string;
+    displayTitle?: string;
+    url: string;
+    about?: {
+        html?: string;
+        text?: string;
+        [key: string]: unknown;
+    };
+    author?: {
+        name: string;
+        username: string;
+        [key: string]: unknown;
+    };
+    favicon?: string;
+}
+export interface HashnodeMe {
+    [key: string]: unknown;
+    id: string;
+    name: string;
+    username: string;
+    profilePicture?: string;
+    publications?: {
+        edges: Array<{
+            node: HashnodePublication;
+            [key: string]: unknown;
+        }>;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@kieksme/mcp-hashnode",
+  "version": "1.1.0",
+  "description": "MCP server for the Hashnode GraphQL API — create drafts, publish posts, manage your blog via Claude",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-hashnode": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kieksme/mcp-hashnode.git"
+  },
+  "homepage": "https://github.com/kieksme/mcp-hashnode",
+  "bugs": {
+    "url": "https://github.com/kieksme/mcp-hashnode/issues"
+  },
+  "keywords": [
+    "mcp",
+    "hashnode",
+    "blog",
+    "graphql",
+    "claude",
+    "ai",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "axios": "^1.7.9",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  }
+}