atheneum-mcp 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-02-18
+
+## [0.4.0] - 2026-02-18
+
+### Fixed
+
+- `list_wiki_pages` and `get_pages_by_tag` returning fewer results than expected due to a buggy `limit` parameter in the Wiki.js GraphQL API; queries now fetch all results and limit client-side
+- Path-scoped wiki instances silently losing results when the parent wiki had many pages outside the configured base path
+
+## [0.3.0] - 2026-02-18
+
+### Added
+
+- Optional `description` field on wiki instances, surfaced in tool parameter hints and error messages
+- `list_wiki_instances` tool for discovering configured wikis and their descriptions
+
 ## [0.2.0] - 2026-02-17
 
 ### Added
@@ -28,5 +44,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Google OAuth tokens now stored in `~/.config/atheneum-mcp/`
 - Configuration via YAML file or environment variables
 
-[Unreleased]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.2.0...main
+[Unreleased]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.4.0...main
+[0.4.0]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.3.0...v0.4.0
+[0.4.0]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.3.0...v0.4.0
+[0.3.0]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.2.0...v0.3.0
 [0.2.0]: https://gitlab.com/morgul/atheneum-mcp/-/compare/v0.1.0...v0.2.0

package/dist/config.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 declare const WikiConfigSchema: z.ZodObject<{
     name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
     url: z.ZodString;
     token: z.ZodString;
     basePath: z.ZodDefault<z.ZodString>;
@@ -15,10 +16,12 @@ declare const WikiConfigSchema: z.ZodObject<{
     readOnly: boolean;
     strictPath: boolean;
     hidePaths: boolean;
+    description?: string | undefined;
 }, {
     name: string;
     url: string;
     token: string;
+    description?: string | undefined;
     basePath?: string | undefined;
     readOnly?: boolean | undefined;
     strictPath?: boolean | undefined;
@@ -46,6 +49,7 @@ declare const DriveConfigSchema: z.ZodObject<{
 declare const AtheneumConfigSchema: z.ZodObject<{
     wikis: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
         url: z.ZodString;
         token: z.ZodString;
         basePath: z.ZodDefault<z.ZodString>;
@@ -60,10 +64,12 @@ declare const AtheneumConfigSchema: z.ZodObject<{
         readOnly: boolean;
         strictPath: boolean;
         hidePaths: boolean;
+        description?: string | undefined;
     }, {
         name: string;
         url: string;
         token: string;
+        description?: string | undefined;
         basePath?: string | undefined;
         readOnly?: boolean | undefined;
         strictPath?: boolean | undefined;
@@ -97,6 +103,7 @@ declare const AtheneumConfigSchema: z.ZodObject<{
         readOnly: boolean;
         strictPath: boolean;
         hidePaths: boolean;
+        description?: string | undefined;
     }[];
     drive?: {
         folders: string[];
@@ -110,6 +117,7 @@ declare const AtheneumConfigSchema: z.ZodObject<{
         name: string;
         url: string;
         token: string;
+        description?: string | undefined;
         basePath?: string | undefined;
         readOnly?: boolean | undefined;
         strictPath?: boolean | undefined;

package/dist/config.js

@@ -11,6 +11,7 @@ import { z } from 'zod';
 //----------------------------------------------------------------------------------------------------------------------
 const WikiConfigSchema = z.object({
     name: z.string(),
+    description: z.string().optional(),
     url: z.string().url(),
     token: z.string(),
     basePath: z.string().default('/'),

package/dist/server.js

@@ -10,12 +10,21 @@ import { DriveClient } from "./driveClient.js";
 //----------------------------------------------------------------------------------------------------------------------
 // Wiki Tool Registration
 //----------------------------------------------------------------------------------------------------------------------
-function registerWikiTools(server, wikiClients) {
+function registerWikiTools(server, wikiClients, wikiConfigs) {
     const multiWiki = wikiClients.size > 1;
+    // Format instance listing with optional descriptions
+    function formatInstanceList() {
+        const entries = [];
+        for (const [name] of wikiClients) {
+            const desc = wikiConfigs.get(name)?.description;
+            entries.push(desc ? `${name} (${desc})` : name);
+        }
+        return entries.join(', ');
+    }
     // Instance parameter -- only present when multiple wikis are configured
     const instanceParam = multiWiki
         ? {
-            instance: z.string().optional().describe(`Wiki instance name. Available: ${[...wikiClients.keys()].join(', ')}`)
+            instance: z.string().optional().describe(`Wiki instance name. Available: ${formatInstanceList()}`)
         }
         : {};
     // Resolve which wiki client to use from the MCP tool args
@@ -28,13 +37,25 @@ function registerWikiTools(server, wikiClients) {
         if (instance) {
             const client = wikiClients.get(instance);
             if (!client) {
-                throw new Error(`Wiki instance '${instance}' not found. `
-                    + `Available: ${[...wikiClients.keys()].join(', ')}`);
+                throw new Error(`Wiki instance '${instance}' not found. Available: ${formatInstanceList()}`);
             }
             return client;
         }
-        throw new Error(`Multiple wikis configured. Specify instance: ${[...wikiClients.keys()].join(', ')}`);
+        throw new Error(`Multiple wikis configured. Specify instance: ${formatInstanceList()}`);
     }
+    // List available wiki instances -- always registered when wikis exist
+    server.tool('list_wiki_instances', 'List all configured wiki instances with their descriptions.', {}, async () => {
+        let text = `Available wiki instances (${wikiClients.size}):\n\n`;
+        for (const [name] of wikiClients) {
+            const desc = wikiConfigs.get(name)?.description;
+            text += `- **${name}**`;
+            if (desc) {
+                text += ` -- ${desc}`;
+            }
+            text += '\n';
+        }
+        return { content: [{ type: 'text', text }] };
+    });
     //------------------------------------------------------------------------------------------------------------------
     // Read Tools
     //------------------------------------------------------------------------------------------------------------------
@@ -509,14 +530,16 @@ export async function startServer(config) {
     });
     // Instantiate wiki clients
     const wikiClients = new Map();
+    const wikiConfigs = new Map();
     for (const wikiConfig of config.wikis) {
         wikiClients.set(wikiConfig.name, new WikiClient(wikiConfig));
+        wikiConfigs.set(wikiConfig.name, { description: wikiConfig.description });
     }
     // Instantiate drive client
     const driveClient = config.drive ? new DriveClient(config.drive) : null;
     // Register tools
     if (wikiClients.size > 0) {
-        registerWikiTools(server, wikiClients);
+        registerWikiTools(server, wikiClients, wikiConfigs);
     }
     if (driveClient) {
         registerDriveTools(server, driveClient);

package/dist/wikiClient.js

@@ -215,10 +215,12 @@ export class WikiClient {
         return data;
     }
     async listPages(limit = 50) {
+        // Wiki.js's limit parameter is buggy -- it returns fewer results than requested.
+        // Fetch all pages and limit client-side instead.
         const query = `
-            query ListPages($limit: Int) {
+            query ListPages {
                 pages {
-                    list(limit: $limit, orderBy: UPDATED, orderByDirection: DESC) {
+                    list(orderBy: UPDATED, orderByDirection: DESC) {
                         id
                         path
                         title
@@ -228,10 +230,10 @@ export class WikiClient {
                 }
             }
         `;
-        const data = await this.graphql(query, { limit });
+        const data = await this.graphql(query);
         const filtered = data.pages.list.filter((p) => this.isPathAllowed(p.path));
         const mapped = filtered.map((p) => ({ ...p, path: this.stripBasePath(p.path) }));
-        return { pages: { list: mapped } };
+        return { pages: { list: mapped.slice(0, limit) } };
     }
     async getPageTree(parentId) {
         const query = `

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "atheneum-mcp",
-    "version": "0.2.0",
+    "version": "0.4.0",
     "description": "MCP server for Wiki.js and Google Drive",
     "author": "Christopher S. Case <chris.case@g33xnexus.com>",
     "license": "WTFPL",