hackmd-mcp/dist/tools/userNotes.js

This is a Model Context Protocol (MCP) server for interacting with the [HackMD API](https://hackmd.io/@hackmd-api/developer-portal). It allows AI assistants to perform operations such as:

import { z } from "zod";
import { CreateNoteOptionsSchema, UpdateNoteOptionsSchema, } from "../utils/schemas.js";
export function registerUserNotesApiTools(server, client) {
    // Tool: List user's notes
    server.tool("list_user_notes", "List all notes owned by the user", {}, {
        title: "Get a list of notes in the user's workspace",
        readOnlyHint: true,
        openWorldHint: true,
    }, async () => {
        try {
            const notes = await client.getNoteList();
            return {
                content: [
                    {
                        type: "text",
                        text: JSON.stringify(notes, null, 2),
                    },
                ],
            };
        }
        catch (error) {
            return {
                content: [{ type: "text", text: `Error: ${error.message}` }],
                isError: true,
            };
        }
    });
    // Tool: Get note by ID
    server.tool("get_note", "Get a note by its ID", {
        noteId: z.string().describe("Note ID"),
    }, {
        title: "Get a note",
        readOnlyHint: true,
        openWorldHint: true,
    }, async ({ noteId }) => {
        try {
            const note = await client.getNote(noteId);
            return {
                content: [
                    {
                        type: "text",
                        text: JSON.stringify(note, null, 2),
                    },
                ],
            };
        }
        catch (error) {
            return {
                content: [{ type: "text", text: `Error: ${error.message}` }],
                isError: true,
            };
        }
    });
    // Tool: Create a new note
    server.tool("create_note", "Create a new note", {
        payload: CreateNoteOptionsSchema.describe("Create note options"),
    }, {
        title: "Create a note",
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
        openWorldHint: true,
    }, async ({ payload }) => {
        try {
            const note = await client.createNote(payload);
            return {
                content: [
                    {
                        type: "text",
                        text: `Note created successfully:\n${JSON.stringify(note, null, 2)}`,
                    },
                ],
            };
        }
        catch (error) {
            return {
                content: [{ type: "text", text: `Error: ${error.message}` }],
                isError: true,
            };
        }
    });
    // Tool: Update a note
    server.tool("update_note", "Update an existing note", {
        noteId: z.string().describe("Note ID"),
        payload: UpdateNoteOptionsSchema.describe("Update note options"),
    }, {
        title: "Update a note",
        readOnlyHint: false,
        destructiveHint: true,
        idempotentHint: false,
        openWorldHint: true,
    }, async ({ noteId, payload }) => {
        try {
            const result = await client.updateNote(noteId, payload);
            return {
                content: [
                    {
                        type: "text",
                        text: `Note ${noteId} updated successfully:\n${JSON.stringify(result, null, 2)}`,
                    },
                ],
            };
        }
        catch (error) {
            return {
                content: [{ type: "text", text: `Error: ${error.message}` }],
                isError: true,
            };
        }
    });
    // Tool: Delete a note
    server.tool("delete_note", "Delete a note", {
        noteId: z.string().describe("Note ID"),
    }, {
        title: "Delete a note",
        readOnlyHint: false,
        destructiveHint: true,
        idempotentHint: true,
        openWorldHint: true,
    }, async ({ noteId }) => {
        try {
            const result = await client.deleteNote(noteId);
            return {
                content: [
                    {
                        type: "text",
                        text: `Note ${noteId} deleted successfully:\n${JSON.stringify(result, null, 2)}`,
                    },
                ],
            };
        }
        catch (error) {
            return {
                content: [{ type: "text", text: `Error: ${error.message}` }],
                isError: true,
            };
        }
    });
}