@xiedada/nodemw-mcp-server 0.0.11 → 0.1.0

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.11",
+  version: "0.1.0",
   description: "MCP server for nodemw - MediaWiki API client",
   type: "module",
   main: "dist/index.js",
@@ -301,7 +301,7 @@ async function handleGetArticleTool(title, followRedirect, redirectInfo, revisio
       });
       const pages = info.pages;
       const page = getFirstItem(pages);
-      if (!page || page.missing) {
+      if (!page || page.missing !== void 0) {
         return {
           content: [{ type: "text", text: `Page "${title}" not found.` }],
           isError: true
@@ -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
     });
@@ -923,17 +961,7 @@ function whoamiTool(server) {
     },
     async () => handleWhoamiTool()
   );
-  tool.update({ outputSchema: { user: z15.object({
-    name: z15.string(),
-    id: z15.number(),
-    groups: z15.array(z15.string()),
-    rights: z15.array(z15.string()),
-    ratelimits: z15.union([z15.record(z15.unknown()), z15.array(z15.unknown())]),
-    editcount: z15.number(),
-    realname: z15.string().optional(),
-    email: z15.string().optional(),
-    emailauthenticated: z15.string().optional()
-  }) } });
+  tool.update({ outputSchema: { user: z15.record(z15.unknown()) } });
   return tool;
 }
 async function handleWhoamiTool() {
@@ -965,18 +993,7 @@ function whoisTool(server) {
     },
     async ({ username }) => handleWhoisTool(username)
   );
-  tool.update({ outputSchema: { user: z16.object({
-    userid: z16.number(),
-    name: z16.string(),
-    groups: z16.array(z16.string()),
-    implicitgroups: z16.array(z16.string()).optional(),
-    rights: z16.array(z16.string()),
-    editcount: z16.number(),
-    registration: z16.string().optional(),
-    emailable: z16.string().optional(),
-    gender: z16.string().optional(),
-    blockinfo: z16.record(z16.unknown()).optional()
-  }) } });
+  tool.update({ outputSchema: { user: z16.record(z16.unknown()) } });
   return tool;
 }
 async function handleWhoisTool(username) {
@@ -987,7 +1004,7 @@ async function handleWhoisTool(username) {
       "whois",
       username
     );
-    if (userInfo.missing) {
+    if (userInfo.missing !== void 0) {
       return errorResult(`User "${username}" not found.`);
     }
     return jsonResult({ user: userInfo });
@@ -1012,18 +1029,7 @@ function whoareTool(server) {
     },
     async (params) => handleWhoareTool(params)
   );
-  tool.update({ outputSchema: { users: z17.array(z17.object({
-    userid: z17.number(),
-    name: z17.string(),
-    groups: z17.array(z17.string()),
-    implicitgroups: z17.array(z17.string()).optional(),
-    rights: z17.array(z17.string()),
-    editcount: z17.number(),
-    registration: z17.string().optional(),
-    emailable: z17.string().optional(),
-    gender: z17.string().optional(),
-    blockinfo: z17.record(z17.unknown()).optional()
-  })), count: z17.number() } });
+  tool.update({ outputSchema: { users: z17.array(z17.record(z17.unknown())), count: z17.number() } });
   return tool;
 }
 async function handleWhoareTool(params) {
@@ -1034,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);
   }
@@ -1203,10 +1212,11 @@ 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")
     },
     {
@@ -1216,10 +1226,10 @@ 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) => {
@@ -1342,9 +1352,10 @@ import { z as z25 } from "zod";
 function getRecentChangesTool(server) {
   const tool = server.tool(
     "get-recent-changes",
-    "Get recent changes on the wiki",
-    {
-      start: z25.string().optional().describe("Start timestamp (YYYYMMDDHHMMSS format)"),
+    "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(
+        '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")
     },
     {
@@ -1429,16 +1440,7 @@ function getSiteStatsTool(server) {
     },
     async () => handleGetSiteStatsTool()
   );
-  tool.update({ outputSchema: { statistics: z27.object({
-    pages: z27.number(),
-    articles: z27.number(),
-    edits: z27.number(),
-    images: z27.number(),
-    users: z27.number(),
-    activeusers: z27.number().optional(),
-    admins: z27.number().optional(),
-    jobs: z27.number().optional()
-  }) } });
+  tool.update({ outputSchema: { statistics: z27.record(z27.unknown()) } });
   return tool;
 }
 async function handleGetSiteStatsTool() {

package/package.json

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