@xiedada/nodemw-mcp-server 0.0.12 → 0.1.1

package/dist/index.js

@@ -37,7 +37,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 // package.json
 var package_default = {
   name: "@xiedada/nodemw-mcp-server",
-  version: "0.0.12",
+  version: "0.1.1",
   description: "MCP server for nodemw - MediaWiki API client",
   type: "module",
   main: "dist/index.js",
@@ -334,7 +334,7 @@ async function handleGetArticleTool(title, followRedirect, redirectInfo, revisio
       const [content, redirect] = result;
       if (content == null) {
         return {
-          content: [{ type: "text", text: `Page "${title}" not found or has no content.` }],
+          content: [{ type: "text", text: `Page "${title}" not found.` }],
           isError: true
         };
       }
@@ -344,7 +344,7 @@ ${content}
 
 Redirect Information:
 
-${JSON.stringify(redirect, null, 2)}` : content;
+${JSON.stringify(redirect, null, 2)}` : content === "" ? "(empty page)" : content;
       await recordReadState(title);
       return {
         content: [{ type: "text", text: responseText }]
@@ -358,13 +358,13 @@ ${JSON.stringify(redirect, null, 2)}` : content;
       );
       if (result == null) {
         return {
-          content: [{ type: "text", text: `Page "${title}" not found or has no content.` }],
+          content: [{ type: "text", text: `Page "${title}" not found.` }],
           isError: true
         };
       }
       await recordReadState(title);
       return {
-        content: [{ type: "text", text: result }]
+        content: [{ type: "text", text: result === "" ? "(empty page)" : result }]
       };
     }
   } catch (error) {
@@ -809,7 +809,7 @@ async function handleGetArticlePropertiesTool(title) {
     );
     return jsonResult({
       title,
-      properties
+      properties: properties || {}
     });
   } catch (error) {
     return errorResult("Failed to get article properties", error);
@@ -866,41 +866,79 @@ import { z as z14 } from "zod";
 function getUserContribsTool(server) {
   const tool = server.tool(
     "get-user-contribs",
-    "Get contributions made by a specific user",
+    "Get contributions made by a specific user. Pagination: the response includes total (matching edits found) and displayed (returned in this batch). If displayed < total, more results exist \u2014 use the timestamp of the LAST returned contribution as the start parameter for the next page. Repeat until displayed < limit to get all results.",
     {
       username: z14.string().describe("Username to get contributions for"),
       namespace: z14.number().optional().describe("Filter contributions by namespace"),
-      limit: z14.number().optional().default(50).describe("Maximum number of contributions to return")
+      limit: z14.number().optional().default(50).describe("Maximum number of contributions to return"),
+      start: z14.string().optional().describe(
+        'Timestamp to start listing from \u2014 only return edits before this time (not inclusive). Accepts ISO 8601 (e.g. "2026-05-10T22:54:37Z"), MediaWiki format "YYYYMMDDHHMMSS", or unix timestamp. All times are UTC \u2014 MW ignores timezone offsets. To paginate: pass the timestamp of the LAST item from the previous page as start. The returned contributions are guaranteed to be strictly older than this timestamp.'
+      )
     },
     {
       title: "Get user contributions",
       readOnlyHint: true,
       destructiveHint: false
     },
-    async ({ username, namespace, limit }) => handleGetUserContribsTool(username, namespace, limit)
+    async ({ username, namespace, limit, start }) => handleGetUserContribsTool(username, namespace, limit, start)
   );
-  tool.update({ outputSchema: { username: z14.string(), namespace: z14.number().optional(), limit: z14.number(), total: z14.number(), displayed: z14.number(), contributions: z14.array(z14.record(z14.unknown())) } });
+  tool.update({ outputSchema: { username: z14.string(), namespace: z14.number().optional(), limit: z14.number(), start: z14.string().optional(), total: z14.number(), displayed: z14.number(), contributions: z14.array(z14.record(z14.unknown())) } });
   return tool;
 }
-async function handleGetUserContribsTool(username, namespace, limit = 50) {
+async function handleGetUserContribsTool(username, namespace, limit = 50, start) {
   try {
     const bot = await getBot();
-    const options = {
-      user: username,
-      ...namespace !== void 0 && { namespace }
-    };
-    const callbackArgs = await promisifyBotMethod(
+    const userInfo = await promisifyBotMethod(
       bot,
-      "getUserContribs",
-      options
+      "whois",
+      username
     );
-    const contribs = Array.isArray(callbackArgs[1]) ? callbackArgs[1] : [];
-    const limitedContribs = contribs.slice(0, limit);
+    if (userInfo.missing !== void 0) {
+      return errorResult(`User "${username}" not found.`);
+    }
+    const allContribs = [];
+    const perPage = Math.min(limit, 500);
+    const baseParams = {
+      action: "query",
+      list: "usercontribs",
+      ucuser: username,
+      uclimit: perPage,
+      ucprop: "ids|title|timestamp|comment|size|flags",
+      ...namespace !== void 0 && { ucnamespace: namespace },
+      ...start && { ucstart: start }
+    };
+    let continueParams;
+    do {
+      const params = { ...baseParams, ...continueParams || {} };
+      const rawData = await new Promise((resolve, reject) => {
+        bot.api.call(params, (_err, _info, _next, raw) => {
+          if (_err) reject(_err);
+          else resolve(raw);
+        });
+      });
+      const usercontribs = rawData.query?.usercontribs;
+      if (usercontribs) {
+        allContribs.push(...usercontribs);
+      }
+      if (allContribs.length >= limit) {
+        break;
+      }
+      if (rawData.continue) {
+        continueParams = rawData.continue;
+      } else if (rawData["query-continue"]) {
+        const qc = rawData["query-continue"];
+        continueParams = qc.usercontribs || qc[Object.keys(qc)[0]];
+      } else {
+        continueParams = void 0;
+      }
+    } while (continueParams);
+    const limitedContribs = allContribs.slice(0, limit);
     return jsonResult({
       username,
       namespace,
       limit,
-      total: contribs.length,
+      start,
+      total: allContribs.length,
       displayed: limitedContribs.length,
       contributions: limitedContribs
     });
@@ -1002,7 +1040,10 @@ async function handleWhoareTool(params) {
       "whoare",
       params.usernames
     );
-    return jsonResult({ users, count: users.length });
+    const normalized = users.map(
+      (u) => u && u.missing !== void 0 ? { ...u, missing: true } : u
+    );
+    return jsonResult({ users: normalized, count: normalized.length });
   } catch (error) {
     return errorResult("Failed to get user information", error);
   }
@@ -1171,10 +1212,12 @@ import { z as z22 } from "zod";
 function getLogTool(server) {
   const tool = server.tool(
     "get-log",
-    "Get log entries of a specific type",
+    "Get log entries of a specific type (e.g. delete, block, move). Pagination: the response includes total (matching entries found) and displayed (returned in this batch). If displayed < total, more results exist \u2014 use the timestamp of the LAST returned entry as the start parameter for the next page.",
     {
       type: z22.string().describe("Log type (e.g. delete, block, move)"),
-      start: z22.string().optional().default("").describe("Start timestamp (YYYYMMDDHHMMSS format)"),
+      start: z22.string().optional().describe(
+        'Timestamp to start listing from \u2014 only return entries before this time. Accepts ISO 8601 (e.g. "2026-05-10T22:54:37Z"), MediaWiki format "YYYYMMDDHHMMSS", or unix timestamp. All times are UTC \u2014 MW ignores timezone offsets. To paginate: pass the timestamp of the LAST item from the previous page as start.'
+      ),
       limit: z22.number().optional().default(50).describe("Maximum number of entries to return")
     },
     {
@@ -1184,14 +1227,14 @@ function getLogTool(server) {
     },
     async ({ type, start, limit }) => handleGetLogTool(type, start, limit)
   );
-  tool.update({ outputSchema: { type: z22.string(), start: z22.string(), limit: z22.number(), total: z22.number(), displayed: z22.number(), entries: z22.array(z22.record(z22.unknown())) } });
+  tool.update({ outputSchema: { type: z22.string(), start: z22.string().optional(), limit: z22.number(), total: z22.number(), displayed: z22.number(), entries: z22.array(z22.record(z22.unknown())) } });
   return tool;
 }
-async function handleGetLogTool(type, start, limit) {
+async function handleGetLogTool(type, start, limit = 50) {
   try {
     const bot = await getBot();
     const entries = await new Promise((resolve, reject) => {
-      bot.getLog(type, start, (err, ...args) => {
+      bot.getLog(type, start || "", (err, ...args) => {
         if (err) {
           reject(err);
         } else {
@@ -1310,9 +1353,11 @@ import { z as z25 } from "zod";
 function getRecentChangesTool(server) {
   const tool = server.tool(
     "get-recent-changes",
-    "Get recent changes on the wiki",
+    "Get recent changes on the wiki. Pagination: the response includes total (matching changes found) and displayed (returned in this batch). If displayed < total, more results exist \u2014 use the timestamp of the LAST returned change as the start parameter for the next page.",
     {
-      start: z25.string().optional().describe("Start timestamp (YYYYMMDDHHMMSS format)"),
+      start: z25.string().optional().describe(
+        'Timestamp to start listing from \u2014 only return changes before this time. Accepts ISO 8601 (e.g. "2026-05-10T22:54:37Z"), MediaWiki format "YYYYMMDDHHMMSS", or unix timestamp. All times are UTC \u2014 MW ignores timezone offsets. To paginate: pass the timestamp of the LAST item from the previous page as start.'
+      ),
       limit: z25.number().optional().default(50).describe("Maximum number of changes to return")
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiedada/nodemw-mcp-server",
-  "version": "0.0.12",
+  "version": "0.1.1",
   "description": "MCP server for nodemw - MediaWiki API client",
   "type": "module",
   "main": "dist/index.js",