@nonz250/notepm-mcp-server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 nonz250
+
+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,143 @@
+# notepm-mcp-server
+
+[![npm version](https://badge.fury.io/js/@nonz250/notepm-mcp-server.svg)](https://www.npmjs.com/package/@nonz250/notepm-mcp-server)
+
+An unofficial [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [NotePM](https://notepm.jp/) - a knowledge management and documentation platform.
+
+This server enables AI assistants like Claude to search, read, create, update, and delete pages in your NotePM workspace.
+
+## Requirements
+
+- Node.js >= 22
+
+## Installation
+
+### Using npx (Recommended)
+
+No installation required. Configure your MCP client to run the server directly with `npx`.
+
+### Global Installation
+
+```bash
+npm install -g @nonz250/notepm-mcp-server
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "notepm": {
+      "command": "npx",
+      "args": ["-y", "@nonz250/notepm-mcp-server"],
+      "env": {
+        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
+        "NOTEPM_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add the following to your Claude Code settings file (`.claude/settings.json` or `.claude/settings.local.json`):
+
+```json
+{
+  "mcpServers": {
+    "notepm": {
+      "command": "npx",
+      "args": ["-y", "@nonz250/notepm-mcp-server"],
+      "env": {
+        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
+        "NOTEPM_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+### Using Global Installation
+
+If you installed globally, replace `npx` with the direct command:
+
+```json
+{
+  "mcpServers": {
+    "notepm": {
+      "command": "notepm-mcp-server",
+      "env": {
+        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
+        "NOTEPM_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_pages` | Search NotePM pages by keyword, note, or tag |
+| `get_page` | Get a page's full content including title, body, and tags |
+| `create_page` | Create a new page in a specified note |
+| `update_page` | Update an existing page's content |
+| `delete_page` | Delete a page (irreversible) |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `NOTEPM_TEAM_DOMAIN` | Yes | Your NotePM team domain (e.g., `demo` for `demo.notepm.jp`) |
+| `NOTEPM_ACCESS_TOKEN` | Yes | API access token from NotePM |
+
+## Getting an Access Token
+
+1. Log in to your NotePM workspace
+2. Go to **Personal Settings** > **Access Token**
+3. Generate a new access token
+4. Copy the token and use it in your configuration
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/nonz250/notepm-mcp-server.git
+cd notepm-mcp-server
+npm install
+npm run build
+```
+
+### Running Locally
+
+```bash
+NOTEPM_TEAM_DOMAIN=your-team NOTEPM_ACCESS_TOKEN=your-token npm run start
+```
+
+### Running Tests
+
+```bash
+npm test
+```
+
+### Linting and Formatting
+
+```bash
+npm run lint
+npm run format
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Load configuration from environment variables
+ *
+ * Required environment variables:
+ * - NOTEPM_TEAM_DOMAIN: Team domain (e.g., "demo" → demo.notepm.jp)
+ * - NOTEPM_ACCESS_TOKEN: API access token
+ */
+export interface Config {
+    teamDomain: string;
+    accessToken: string;
+    baseUrl: string;
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAyBnC"}

package/dist/config.js

@@ -0,0 +1,26 @@
+/**
+ * Load configuration from environment variables
+ *
+ * Required environment variables:
+ * - NOTEPM_TEAM_DOMAIN: Team domain (e.g., "demo" → demo.notepm.jp)
+ * - NOTEPM_ACCESS_TOKEN: API access token
+ */
+export function loadConfig() {
+    const teamDomain = process.env.NOTEPM_TEAM_DOMAIN;
+    const accessToken = process.env.NOTEPM_ACCESS_TOKEN;
+    if (!teamDomain) {
+        throw new Error("Environment variable NOTEPM_TEAM_DOMAIN is not set.\n" +
+            "Example: export NOTEPM_TEAM_DOMAIN=demo");
+    }
+    if (!accessToken) {
+        throw new Error("Environment variable NOTEPM_ACCESS_TOKEN is not set.\n" +
+            "Get it from NotePM: Personal Settings > Access Token");
+    }
+    const baseUrl = `https://${teamDomain}.notepm.jp/api/v1`;
+    return {
+        teamDomain,
+        accessToken,
+        baseUrl,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAEpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,yCAAyC,CAC5C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,sDAAsD,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,UAAU,mBAAmB,CAAC;IAEzD,OAAO;QACL,UAAU;QACV,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * NotePM MCP Server
+ *
+ * MCP server for NotePM API integration.
+ * Enables Claude Desktop and Claude Code to search, retrieve, and create NotePM pages.
+ *
+ * Required environment variables:
+ * - NOTEPM_TEAM_DOMAIN: Team domain (e.g., "demo")
+ * - NOTEPM_ACCESS_TOKEN: API access token
+ */
+import { createRequire } from "node:module";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { NotePMClient } from "./notepm-client.js";
+import { TOOLS, handleToolCall } from "./tools/index.js";
+// ============================================================
+// Load package info
+// ============================================================
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+// ============================================================
+// Load configuration and initialize client
+// ============================================================
+const config = loadConfig();
+const client = new NotePMClient(config);
+// ============================================================
+// Create server instance
+// ============================================================
+// TODO: Consider migrating to McpServer high-level API
+// Currently using Server for setRequestHandler which requires low-level API
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+const server = new Server({
+    name: packageJson.name,
+    version: packageJson.version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ============================================================
+// Set up request handlers
+// ============================================================
+/**
+ * Handler for tools/list request
+ */
+server.setRequestHandler(ListToolsRequestSchema, () => {
+    return { tools: TOOLS };
+});
+/**
+ * Handler for tools/call request
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    return handleToolCall(client, name, args);
+});
+// ============================================================
+// Start server
+// ============================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`NotePM MCP Server started (${config.teamDomain}.notepm.jp)`);
+}
+main().catch((error) => {
+    console.error("Server startup error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzD,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAEpF,+DAA+D;AAC/D,2CAA2C;AAC3C,+DAA+D;AAE/D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAExC,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D,uDAAuD;AACvD,4EAA4E;AAC5E,4DAA4D;AAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,+DAA+D;AAC/D,0BAA0B;AAC1B,+DAA+D;AAE/D;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,UAAU,aAAa,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/notepm-client.d.ts

@@ -0,0 +1,107 @@
+/**
+ * NotePM API Client
+ *
+ * Handles communication with NotePM REST API
+ * https://notepm.jp/docs/api
+ */
+import { Config } from "./config.js";
+/** User information */
+export interface User {
+    user_code: string;
+    name: string;
+}
+/** Tag information */
+export interface Tag {
+    name: string;
+}
+/** Page information */
+export interface Page {
+    page_code: string;
+    note_code: string;
+    folder_id: number | null;
+    title: string;
+    body: string;
+    memo: string;
+    created_at: string;
+    updated_at: string;
+    created_by: User;
+    updated_by: User;
+    tags: Tag[];
+}
+/** Pagination metadata */
+export interface PaginationMeta {
+    previous_page: string | null;
+    next_page: string | null;
+    page: number;
+    per_page: number;
+    total: number;
+}
+/** Pages list response */
+export interface PagesResponse {
+    pages: Page[];
+    meta: PaginationMeta;
+}
+/** Single page response */
+export interface PageResponse {
+    page: Page;
+}
+/** Search pages parameters */
+export interface SearchPagesParams {
+    q?: string;
+    only_title?: boolean;
+    include_archived?: boolean;
+    note_code?: string;
+    tag_name?: string;
+    page?: number;
+    per_page?: number;
+}
+/** Create page parameters */
+export interface CreatePageParams {
+    note_code: string;
+    title: string;
+    body?: string;
+    memo?: string;
+    folder_id?: number;
+    tags?: string[];
+}
+/** API Error */
+export declare class NotePMAPIError extends Error {
+    statusCode: number;
+    statusText: string;
+    constructor(statusCode: number, statusText: string, message: string);
+}
+export declare class NotePMClient {
+    private baseUrl;
+    private accessToken;
+    constructor(config: Config);
+    /**
+     * Send API request
+     */
+    private request;
+    /**
+     * Search pages
+     * GET /api/v1/pages
+     */
+    searchPages(params?: SearchPagesParams): Promise<PagesResponse>;
+    /**
+     * Get page
+     * GET /api/v1/pages/:page_code
+     */
+    getPage(pageCode: string): Promise<Page>;
+    /**
+     * Create page
+     * POST /api/v1/pages
+     */
+    createPage(params: CreatePageParams): Promise<Page>;
+    /**
+     * Update page
+     * PATCH /api/v1/pages/:page_code
+     */
+    updatePage(pageCode: string, params: Partial<Omit<CreatePageParams, "note_code">>): Promise<Page>;
+    /**
+     * Delete page
+     * DELETE /api/v1/pages/:page_code
+     */
+    deletePage(pageCode: string): Promise<void>;
+}
+//# sourceMappingURL=notepm-client.d.ts.map

package/dist/notepm-client.d.ts.map

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

package/dist/notepm-client.js

@@ -0,0 +1,102 @@
+/** API Error */
+export class NotePMAPIError extends Error {
+    statusCode;
+    statusText;
+    constructor(statusCode, statusText, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.name = "NotePMAPIError";
+    }
+}
+// ============================================================
+// API Client
+// ============================================================
+export class NotePMClient {
+    baseUrl;
+    accessToken;
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.accessToken = config.accessToken;
+    }
+    /**
+     * Send API request
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+            "Content-Type": "application/json",
+        };
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new NotePMAPIError(response.status, response.statusText, `NotePM API Error: ${String(response.status)} ${response.statusText}\n${errorText}`);
+        }
+        // Return empty object for 204 No Content
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    /**
+     * Search pages
+     * GET /api/v1/pages
+     */
+    async searchPages(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.q)
+            searchParams.set("q", params.q);
+        if (params.only_title)
+            searchParams.set("only_title", "true");
+        if (params.include_archived)
+            searchParams.set("include_archived", "true");
+        if (params.note_code)
+            searchParams.set("note_code", params.note_code);
+        if (params.tag_name)
+            searchParams.set("tag_name", params.tag_name);
+        if (params.page)
+            searchParams.set("page", params.page.toString());
+        if (params.per_page)
+            searchParams.set("per_page", params.per_page.toString());
+        const query = searchParams.toString();
+        const path = `/pages${query ? `?${query}` : ""}`;
+        return this.request("GET", path);
+    }
+    /**
+     * Get page
+     * GET /api/v1/pages/:page_code
+     */
+    async getPage(pageCode) {
+        const response = await this.request("GET", `/pages/${pageCode}`);
+        return response.page;
+    }
+    /**
+     * Create page
+     * POST /api/v1/pages
+     */
+    async createPage(params) {
+        const response = await this.request("POST", "/pages", params);
+        return response.page;
+    }
+    /**
+     * Update page
+     * PATCH /api/v1/pages/:page_code
+     */
+    async updatePage(pageCode, params) {
+        const response = await this.request("PATCH", `/pages/${pageCode}`, params);
+        return response.page;
+    }
+    /**
+     * Delete page
+     * DELETE /api/v1/pages/:page_code
+     */
+    async deletePage(pageCode) {
+        await this.request("DELETE", `/pages/${pageCode}`);
+    }
+}
+//# sourceMappingURL=notepm-client.js.map

package/dist/notepm-client.js.map

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

package/dist/tools/constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool Constants
+ *
+ * Centralized constants for tool names to ensure type safety
+ * and prevent string duplication across the codebase.
+ */
+/**
+ * Tool names used throughout the MCP server
+ */
+export declare const TOOL_NAMES: {
+    readonly SEARCH_PAGES: "search_pages";
+    readonly GET_PAGE: "get_page";
+    readonly CREATE_PAGE: "create_page";
+    readonly UPDATE_PAGE: "update_page";
+    readonly DELETE_PAGE: "delete_page";
+};
+/**
+ * Type representing valid tool names
+ */
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/tools/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/tools/constants.js

@@ -0,0 +1,17 @@
+/**
+ * Tool Constants
+ *
+ * Centralized constants for tool names to ensure type safety
+ * and prevent string duplication across the codebase.
+ */
+/**
+ * Tool names used throughout the MCP server
+ */
+export const TOOL_NAMES = {
+    SEARCH_PAGES: "search_pages",
+    GET_PAGE: "get_page",
+    CREATE_PAGE: "create_page",
+    UPDATE_PAGE: "update_page",
+    DELETE_PAGE: "delete_page",
+};
+//# sourceMappingURL=constants.js.map

package/dist/tools/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/tools/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/tools/definitions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Tool Definitions
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const TOOLS: Tool[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/tools/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAmB/D,eAAO,MAAM,KAAK,EAAE,IAAI,EA0BvB,CAAC"}

package/dist/tools/definitions.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { TOOL_NAMES } from "./constants.js";
+import { CreatePageInputSchema, DeletePageInputSchema, GetPageInputSchema, SearchPagesInputSchema, UpdatePageInputSchema, } from "./schemas.js";
+/**
+ * Convert Zod schema to MCP-compatible JSON Schema
+ */
+function toInputSchema(schema) {
+    return z.toJSONSchema(schema, { target: "draft-07" });
+}
+export const TOOLS = [
+    {
+        name: TOOL_NAMES.SEARCH_PAGES,
+        description: "Search NotePM pages. Can filter by keyword, note, or tag.",
+        inputSchema: toInputSchema(SearchPagesInputSchema),
+    },
+    {
+        name: TOOL_NAMES.GET_PAGE,
+        description: "Get a NotePM page. Retrieve title, body, tags and other details by page code.",
+        inputSchema: toInputSchema(GetPageInputSchema),
+    },
+    {
+        name: TOOL_NAMES.CREATE_PAGE,
+        description: "Create a new page in NotePM. Note code and title are required.",
+        inputSchema: toInputSchema(CreatePageInputSchema),
+    },
+    {
+        name: TOOL_NAMES.UPDATE_PAGE,
+        description: "Update an existing NotePM page. Page code is required.",
+        inputSchema: toInputSchema(UpdatePageInputSchema),
+    },
+    {
+        name: TOOL_NAMES.DELETE_PAGE,
+        description: "Delete a NotePM page. This action cannot be undone.",
+        inputSchema: toInputSchema(DeletePageInputSchema),
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,SAAS,aAAa,CAAC,MAAiB;IACtC,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAwB,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAW;IAC3B;QACE,IAAI,EAAE,UAAU,CAAC,YAAY;QAC7B,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE,aAAa,CAAC,sBAAsB,CAAC;KACnD;IACD;QACE,IAAI,EAAE,UAAU,CAAC,QAAQ;QACzB,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE,aAAa,CAAC,kBAAkB,CAAC;KAC/C;IACD;QACE,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE,aAAa,CAAC,qBAAqB,CAAC;KAClD;IACD;QACE,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,aAAa,CAAC,qBAAqB,CAAC;KAClD;IACD;QACE,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,aAAa,CAAC,qBAAqB,CAAC;KAClD;CACF,CAAC"}

package/dist/tools/handlers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool Handlers
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { NotePMClient } from "../notepm-client.js";
+/**
+ * Execute tool
+ */
+export declare function handleToolCall(client: NotePMClient, name: string, args: unknown): Promise<CallToolResult>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/tools/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAkB,YAAY,EAAQ,MAAM,qBAAqB,CAAC;AAwEzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,CAAC,CA2DzB"}

package/dist/tools/handlers.js

@@ -0,0 +1,110 @@
+import { NotePMAPIError } from "../notepm-client.js";
+import { TOOL_NAMES } from "./constants.js";
+import { CreatePageInputSchema, DeletePageInputSchema, GetPageInputSchema, SearchPagesInputSchema, UpdatePageInputSchema, } from "./schemas.js";
+// ============================================================
+// Types and Helpers
+// ============================================================
+/**
+ * Create a successful tool result
+ */
+function success(text) {
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Create an error tool result
+ */
+function error(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+/**
+ * Input validation error
+ */
+class InputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InputError";
+    }
+}
+/**
+ * Parse and validate input, throw InputError on failure
+ */
+function parseInput(schema, args) {
+    const result = schema.safeParse(args);
+    if (!result.success) {
+        throw new InputError(result.error.message);
+    }
+    return result.data;
+}
+/**
+ * Format page information
+ */
+function formatPage(page) {
+    const tags = page.tags.map((t) => t.name).join(", ") || "None";
+    return [
+        `## ${page.title}`,
+        `- Page code: ${page.page_code}`,
+        `- Note code: ${page.note_code}`,
+        `- Created by: ${page.created_by.name}`,
+        `- Created at: ${page.created_at}`,
+        `- Updated at: ${page.updated_at}`,
+        `- Tags: ${tags}`,
+        "",
+        "### Body",
+        page.body || "(No body)",
+    ].join("\n");
+}
+// ============================================================
+// Main Handler
+// ============================================================
+/**
+ * Execute tool
+ */
+export async function handleToolCall(client, name, args) {
+    try {
+        switch (name) {
+            case TOOL_NAMES.SEARCH_PAGES: {
+                const { query, note_code, tag_name, per_page } = parseInput(SearchPagesInputSchema, args);
+                const result = await client.searchPages({ q: query, note_code, tag_name, per_page });
+                if (result.pages.length === 0) {
+                    return success("Search results: 0 pages");
+                }
+                const pageList = result.pages
+                    .map((p, i) => `${String(i + 1)}. **${p.title}** (code: ${p.page_code})\n   - Note: ${p.note_code} | Updated: ${p.updated_at}`)
+                    .join("\n");
+                return success(`Search results: showing ${String(result.pages.length)} of ${String(result.meta.total)} pages\n\n${pageList}`);
+            }
+            case TOOL_NAMES.GET_PAGE: {
+                const { page_code } = parseInput(GetPageInputSchema, args);
+                const page = await client.getPage(page_code);
+                return success(formatPage(page));
+            }
+            case TOOL_NAMES.CREATE_PAGE: {
+                const { note_code, title, body, memo, tags } = parseInput(CreatePageInputSchema, args);
+                const page = await client.createPage({ note_code, title, body, memo, tags });
+                return success(`Page created.\n\n${formatPage(page)}`);
+            }
+            case TOOL_NAMES.UPDATE_PAGE: {
+                const { page_code, title, body, memo, tags } = parseInput(UpdatePageInputSchema, args);
+                const page = await client.updatePage(page_code, { title, body, memo, tags });
+                return success(`Page updated.\n\n${formatPage(page)}`);
+            }
+            case TOOL_NAMES.DELETE_PAGE: {
+                const { page_code } = parseInput(DeletePageInputSchema, args);
+                await client.deletePage(page_code);
+                return success(`Page deleted: ${page_code}`);
+            }
+            default:
+                return error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof InputError) {
+            return error(`Input error: ${err.message}`);
+        }
+        if (err instanceof NotePMAPIError) {
+            return error(err.message);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/tools/handlers.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools for NotePM API integration
+ */
+export * from "./constants.js";
+export * from "./schemas.js";
+export * from "./definitions.js";
+export * from "./handlers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools for NotePM API integration
+ */
+export * from "./constants.js";
+export * from "./schemas.js";
+export * from "./definitions.js";
+export * from "./handlers.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Input Schema Definitions (Zod)
+ *
+ * These schemas are the single source of truth for input validation.
+ * Types are inferred from schemas to avoid duplication.
+ */
+import { z } from "zod";
+export declare const SearchPagesInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    note_code: z.ZodOptional<z.ZodString>;
+    tag_name: z.ZodOptional<z.ZodString>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const GetPageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+}, z.core.$strip>;
+export declare const CreatePageInputSchema: z.ZodObject<{
+    note_code: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const UpdatePageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const DeletePageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+}, z.core.$strip>;
+/** Inferred type for search pages input */
+export type SearchPagesInput = z.infer<typeof SearchPagesInputSchema>;
+/** Inferred type for get page input */
+export type GetPageInput = z.infer<typeof GetPageInputSchema>;
+/** Inferred type for create page input */
+export type CreatePageInput = z.infer<typeof CreatePageInputSchema>;
+/** Inferred type for update page input */
+export type UpdatePageInput = z.infer<typeof UpdatePageInputSchema>;
+/** Inferred type for delete page input */
+export type DeletePageInput = z.infer<typeof DeletePageInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB;;;;;iBAWjC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAMH,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,43 @@
+/**
+ * Input Schema Definitions (Zod)
+ *
+ * These schemas are the single source of truth for input validation.
+ * Types are inferred from schemas to avoid duplication.
+ */
+import { z } from "zod";
+// ============================================================
+// Zod Schemas
+// ============================================================
+export const SearchPagesInputSchema = z.object({
+    query: z.string().optional().describe("Search keyword"),
+    note_code: z.string().optional().describe("Note code (search within specific note)"),
+    tag_name: z.string().optional().describe("Filter by tag name"),
+    per_page: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(20)
+        .describe("Number of results (1-100, default: 20)"),
+});
+export const GetPageInputSchema = z.object({
+    page_code: z.string().min(1).describe("Page code"),
+});
+export const CreatePageInputSchema = z.object({
+    note_code: z.string().min(1).describe("Note code to create page in"),
+    title: z.string().min(1).max(100).describe("Page title (1-100 characters)"),
+    body: z.string().optional().describe("Page body (Markdown format)"),
+    memo: z.string().max(255).optional().describe("Memo (max 255 characters)"),
+    tags: z.array(z.string()).optional().describe("Array of tags"),
+});
+export const UpdatePageInputSchema = z.object({
+    page_code: z.string().min(1).describe("Page code to update"),
+    title: z.string().max(100).optional().describe("Page title (max 100 characters)"),
+    body: z.string().optional().describe("Page body (Markdown format)"),
+    memo: z.string().max(255).optional().describe("Memo (max 255 characters)"),
+    tags: z.array(z.string()).optional().describe("Array of tags"),
+});
+export const DeletePageInputSchema = z.object({
+    page_code: z.string().min(1).describe("Page code to delete"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACpF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC7D,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Define MCP tools for NotePM API integration
+ */
+import { z } from "zod";
+import { NotePMClient } from "./notepm-client.js";
+export declare const SearchPagesInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    note_code: z.ZodOptional<z.ZodString>;
+    tag_name: z.ZodOptional<z.ZodString>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const GetPageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+}, z.core.$strip>;
+export declare const CreatePageInputSchema: z.ZodObject<{
+    note_code: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const UpdatePageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const DeletePageInputSchema: z.ZodObject<{
+    page_code: z.ZodString;
+}, z.core.$strip>;
+export declare const TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}[];
+type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+/**
+ * Execute tool
+ */
+export declare function handleToolCall(client: NotePMClient, name: string, args: unknown): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAMxE,eAAO,MAAM,sBAAsB;;;;;iBAWjC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAcH,eAAO,MAAM,KAAK;;;;GA0BjB,CAAC;AAMF,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAwDxF;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,UAAU,CAAC,CAyDrB"}

package/dist/tools.js

@@ -0,0 +1,179 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Define MCP tools for NotePM API integration
+ */
+import { z } from "zod";
+import { NotePMAPIError } from "./notepm-client.js";
+// ============================================================
+// Input Schema Definitions (Zod)
+// ============================================================
+export const SearchPagesInputSchema = z.object({
+    query: z.string().optional().describe("Search keyword"),
+    note_code: z.string().optional().describe("Note code (search within specific note)"),
+    tag_name: z.string().optional().describe("Filter by tag name"),
+    per_page: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(20)
+        .describe("Number of results (1-100, default: 20)"),
+});
+export const GetPageInputSchema = z.object({
+    page_code: z.string().describe("Page code"),
+});
+export const CreatePageInputSchema = z.object({
+    note_code: z.string().describe("Note code to create page in"),
+    title: z.string().max(100).describe("Page title (max 100 characters)"),
+    body: z.string().optional().describe("Page body (Markdown format)"),
+    memo: z.string().max(255).optional().describe("Memo (max 255 characters)"),
+    tags: z.array(z.string()).optional().describe("Array of tags"),
+});
+export const UpdatePageInputSchema = z.object({
+    page_code: z.string().describe("Page code to update"),
+    title: z.string().max(100).optional().describe("Page title (max 100 characters)"),
+    body: z.string().optional().describe("Page body (Markdown format)"),
+    memo: z.string().max(255).optional().describe("Memo (max 255 characters)"),
+    tags: z.array(z.string()).optional().describe("Array of tags"),
+});
+export const DeletePageInputSchema = z.object({
+    page_code: z.string().describe("Page code to delete"),
+});
+// ============================================================
+// Helper: Convert Zod schema to MCP-compatible JSON Schema
+// ============================================================
+function toInputSchema(schema) {
+    return z.toJSONSchema(schema, { target: "draft-07" });
+}
+// ============================================================
+// Tool Definitions (MCP format)
+// ============================================================
+export const TOOLS = [
+    {
+        name: "search_pages",
+        description: "Search NotePM pages. Can filter by keyword, note, or tag.",
+        inputSchema: toInputSchema(SearchPagesInputSchema),
+    },
+    {
+        name: "get_page",
+        description: "Get a NotePM page. Retrieve title, body, tags and other details by page code.",
+        inputSchema: toInputSchema(GetPageInputSchema),
+    },
+    {
+        name: "create_page",
+        description: "Create a new page in NotePM. Note code and title are required.",
+        inputSchema: toInputSchema(CreatePageInputSchema),
+    },
+    {
+        name: "update_page",
+        description: "Update an existing NotePM page. Page code is required.",
+        inputSchema: toInputSchema(UpdatePageInputSchema),
+    },
+    {
+        name: "delete_page",
+        description: "Delete a NotePM page. This action cannot be undone.",
+        inputSchema: toInputSchema(DeletePageInputSchema),
+    },
+];
+/**
+ * Create a successful tool result
+ */
+function success(text) {
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Create an error tool result
+ */
+function error(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+/**
+ * Input validation error
+ */
+class InputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InputError";
+    }
+}
+/**
+ * Parse and validate input, throw InputError on failure
+ */
+function parseInput(schema, args) {
+    const result = schema.safeParse(args);
+    if (!result.success) {
+        throw new InputError(result.error.message);
+    }
+    return result.data;
+}
+/**
+ * Format page information
+ */
+function formatPage(page) {
+    const tags = page.tags.map((t) => t.name).join(", ") || "None";
+    return [
+        `## ${page.title}`,
+        `- Page code: ${page.page_code}`,
+        `- Note code: ${page.note_code}`,
+        `- Created by: ${page.created_by.name}`,
+        `- Created at: ${page.created_at}`,
+        `- Updated at: ${page.updated_at}`,
+        `- Tags: ${tags}`,
+        "",
+        "### Body",
+        page.body || "(No body)",
+    ].join("\n");
+}
+/**
+ * Execute tool
+ */
+export async function handleToolCall(client, name, args) {
+    try {
+        switch (name) {
+            case "search_pages": {
+                const { query, note_code, tag_name, per_page } = parseInput(SearchPagesInputSchema, args);
+                const result = await client.searchPages({ q: query, note_code, tag_name, per_page });
+                if (result.pages.length === 0) {
+                    return success("Search results: 0 pages");
+                }
+                const pageList = result.pages
+                    .map((p, i) => `${i + 1}. **${p.title}** (code: ${p.page_code})\n   - Note: ${p.note_code} | Updated: ${p.updated_at}`)
+                    .join("\n");
+                return success(`Search results: showing ${result.pages.length} of ${result.meta.total} pages\n\n${pageList}`);
+            }
+            case "get_page": {
+                const { page_code } = parseInput(GetPageInputSchema, args);
+                const page = await client.getPage(page_code);
+                return success(formatPage(page));
+            }
+            case "create_page": {
+                const { note_code, title, body, memo, tags } = parseInput(CreatePageInputSchema, args);
+                const page = await client.createPage({ note_code, title, body, memo, tags });
+                return success(`Page created.\n\n${formatPage(page)}`);
+            }
+            case "update_page": {
+                const { page_code, title, body, memo, tags } = parseInput(UpdatePageInputSchema, args);
+                const page = await client.updatePage(page_code, { title, body, memo, tags });
+                return success(`Page updated.\n\n${formatPage(page)}`);
+            }
+            case "delete_page": {
+                const { page_code } = parseInput(DeletePageInputSchema, args);
+                await client.deletePage(page_code);
+                return success(`Page deleted: ${page_code}`);
+            }
+            default:
+                return error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof InputError) {
+            return error(`Input error: ${err.message}`);
+        }
+        if (err instanceof NotePMAPIError) {
+            return error(err.message);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@nonz250/notepm-mcp-server",
+  "version": "0.0.1",
+  "description": "An unofficial MCP server for NotePM - a knowledge management platform",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "notepm-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "prepublishOnly": "npm run build && npm test && npm run lint"
+  },
+  "keywords": [
+    "mcp",
+    "notepm",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "knowledge-management"
+  ],
+  "author": "nonz250",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nonz250/notepm-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nonz250/notepm-mcp-server/issues"
+  },
+  "homepage": "https://github.com/nonz250/notepm-mcp-server#readme",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
+    "@types/node": "^22.19.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.7.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^4.0.16"
+  }
+}