aiquila-mcp 0.3.20 → 0.3.22

package/dist/tool-registry.js

@@ -33,6 +33,7 @@ import { talkTools } from './tools/apps/talk.js';
 import { userStatusTools } from './tools/apps/user-status.js';
 import { absenceTools } from './tools/apps/absence.js';
 import { notificationsTools } from './tools/apps/notifications.js';
+import { activityTools } from './tools/apps/activity.js';
 import { trashTools } from './tools/apps/trash.js';
 import { versionsTools } from './tools/apps/versions.js';
 import { projectsTools } from './tools/apps/projects.js';
@@ -86,6 +87,7 @@ export const TOOL_REGISTRY = [
     { category: 'translate', appIds: ['text_translate', 'translate'], tools: translateTools },
     { category: 'user_status', appIds: ['user_status'], tools: userStatusTools },
     { category: 'notifications', appIds: ['notifications'], tools: notificationsTools },
+    { category: 'activity', appIds: ['activity'], tools: activityTools },
 ];
 const ALL_CATEGORIES = new Set(TOOL_REGISTRY.map((e) => e.category));
 /**

package/dist/tools/apps/activity.js

@@ -0,0 +1,127 @@
+// SPDX-License-Identifier: MIT
+import { z } from 'zod';
+import { fetchOCS } from '../../client/ocs.js';
+function formatActivities(activities) {
+    return activities
+        .map((a) => {
+        const time = a.datetime ? ` (${a.datetime})` : '';
+        const msg = a.message ? `\n  ${a.message}` : '';
+        return `- [${a.app}] ${a.subject}${time}${msg}`;
+    })
+        .join('\n');
+}
+// ---------------------------------------------------------------------------
+// list_activity
+// ---------------------------------------------------------------------------
+export const listActivityTool = {
+    name: 'list_activity',
+    description: 'List recent entries from the Nextcloud activity feed (file changes, shares, ' +
+        'comments, calendar/contact edits, etc.) for the current user.',
+    inputSchema: z.object({
+        filter: z
+            .enum(['all', 'self', 'by'])
+            .optional()
+            .describe("Which feed to read: 'all' (default), 'self' (your own actions), or 'by' (others' actions)"),
+        limit: z.number().optional().describe('Maximum number of activities to return (default 50)'),
+        since: z
+            .number()
+            .optional()
+            .describe('Return activities after this activity_id (for pagination)'),
+        sort: z
+            .enum(['asc', 'desc'])
+            .optional()
+            .describe("Sort order by time: 'desc' (newest first, default) or 'asc'"),
+    }),
+    handler: async (args) => {
+        try {
+            const filter = args.filter ?? 'all';
+            const queryParams = {
+                limit: String(args.limit ?? 50),
+                sort: args.sort ?? 'desc',
+            };
+            if (args.since !== undefined)
+                queryParams.since = String(args.since);
+            const result = await fetchOCS(`/ocs/v2.php/apps/activity/api/v2/activity/${filter}`, { queryParams });
+            const activities = result.ocs.data;
+            if (activities.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No activity.' }],
+                };
+            }
+            const lastId = activities[activities.length - 1].activity_id;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Activity (${activities.length}):\n${formatActivities(activities)}\n\n` +
+                            `Last activity_id: ${lastId} (pass as 'since' to page further).`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing activity: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+// ---------------------------------------------------------------------------
+// get_object_activity
+// ---------------------------------------------------------------------------
+export const getObjectActivityTool = {
+    name: 'get_object_activity',
+    description: 'List the activity history for a single object, e.g. one file. Use object_type ' +
+        "'files' with a file ID to see what happened to that file.",
+    inputSchema: z.object({
+        object_type: z.string().optional().describe("The object type to filter by (default 'files')"),
+        object_id: z.string().describe('The object ID (e.g. the Nextcloud file ID)'),
+        limit: z.number().optional().describe('Maximum number of activities to return (default 50)'),
+    }),
+    handler: async (args) => {
+        try {
+            const result = await fetchOCS('/ocs/v2.php/apps/activity/api/v2/activity/filter', {
+                queryParams: {
+                    object_type: args.object_type ?? 'files',
+                    object_id: args.object_id,
+                    limit: String(args.limit ?? 50),
+                },
+            });
+            const activities = result.ocs.data;
+            if (activities.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No activity for this object.' }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Activity (${activities.length}):\n${formatActivities(activities)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting object activity: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+// ---------------------------------------------------------------------------
+// Export
+// ---------------------------------------------------------------------------
+export const activityTools = [listActivityTool, getObjectActivityTool];

package/dist/tools/system/files.js

@@ -478,6 +478,126 @@ export const bulkFileOperationsTool = {
         };
     },
 };
+/**
+ * Create a zip archive from one or more files/folders
+ */
+export const createArchiveTool = {
+    name: 'create_archive',
+    description: 'Create a zip archive in Nextcloud from one or more files and/or folders. Runs server-side; not bound by MCP file-size limits.',
+    inputSchema: z.object({
+        sources: z
+            .array(z.string())
+            .min(1)
+            .describe("Paths of files/folders to include (e.g., ['/Documents/a.txt', '/Photos'])"),
+        destination: z
+            .string()
+            .describe("Path for the resulting .zip file (e.g., '/Documents/backup.zip')"),
+        overwrite: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Whether to overwrite the destination if it already exists'),
+    }),
+    handler: async (args) => {
+        try {
+            const result = await fetchAiquilaAPI('/files/zip', {
+                method: 'POST',
+                body: {
+                    sources: args.sources,
+                    destination: args.destination,
+                    overwrite: args.overwrite,
+                },
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error creating archive: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+/**
+ * Extract a zip archive into a destination folder
+ */
+export const extractArchiveTool = {
+    name: 'extract_archive',
+    description: 'Extract a zip archive in Nextcloud into a destination folder. Runs server-side.',
+    inputSchema: z.object({
+        archive: z.string().describe("Path to the .zip file (e.g., '/Documents/backup.zip')"),
+        destination: z.string().describe("Folder to extract into (e.g., '/Documents/restored')"),
+        overwrite: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Whether to overwrite entries that already exist'),
+    }),
+    handler: async (args) => {
+        try {
+            const result = await fetchAiquilaAPI('/files/unzip', {
+                method: 'POST',
+                body: {
+                    archive: args.archive,
+                    destination: args.destination,
+                    overwrite: args.overwrite,
+                },
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error extracting archive: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+/**
+ * List the contents of a zip archive without extracting
+ */
+export const listArchiveTool = {
+    name: 'list_archive',
+    description: 'List the contents of a zip archive in Nextcloud without extracting it.',
+    inputSchema: z.object({
+        archive: z.string().describe("Path to the .zip file (e.g., '/Documents/backup.zip')"),
+    }),
+    handler: async (args) => {
+        try {
+            const result = await fetchAiquilaAPI('/files/zip/list', {
+                queryParams: { archive: args.archive },
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing archive: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
 /**
  * Export all file system tools
  */
@@ -494,4 +614,7 @@ export const fileSystemTools = [
     getFileContentTool,
     analyzeImageTool,
     bulkFileOperationsTool,
+    createArchiveTool,
+    extractArchiveTool,
+    listArchiveTool,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiquila-mcp",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "Nextcloud MCP server — files, calendar, contacts, mail, maps, notes, tasks & 120+ more tools",
   "type": "module",
   "main": "dist/index.js",
@@ -43,6 +43,7 @@
   ],
   "overrides": {
     "brace-expansion": "^2.0.3",
+    "esbuild": ">=0.28.1",
     "hono": "^4.12.14"
   },
   "dependencies": {