aiquila-mcp 0.3.3 → 0.3.5

package/README.md

@@ -1,6 +1,6 @@
 # AIquila MCP Server
 
-MCP (Model Context Protocol) server that gives any MCP client full access to your Nextcloud instance — files, calendar, tasks, contacts, mail, talk, maps, bookmarks, notes, and more. 198 tools across 31 categories.
+MCP (Model Context Protocol) server that gives any MCP client full access to your Nextcloud instance — files, calendar, tasks, contacts, mail, talk, maps, bookmarks, notes, polls, forms, and more. 244 tools across 33 categories.
 
 ## Quick Start
 
@@ -73,11 +73,13 @@ See the [Docker setup guide](https://github.com/elgorro/aiquila/blob/main/docs/m
 | Talk          |    10 |
 | Circles       |     8 |
 | Bookmarks     |    13 |
+| Polls         |    21 |
+| Forms         |    25 |
 | Assistant     |     4 |
 | Translate     |     1 |
 | User Status   |     5 |
 | Notifications |     4 |
-| **Total**     | **198** |
+| **Total**     | **244** |
 
 ## Configuration
 

package/dist/client/forms.js

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: MIT
+import { getNextcloudConfig } from '../tools/types.js';
+import { logger } from '../logger.js';
+import { ApiError } from './aiquila.js';
+/**
+ * Make an authenticated request to the Nextcloud Forms REST API v3.
+ *
+ * Base path: /ocs/v2.php/apps/forms/api/v3
+ * Unwraps the OCS envelope and returns `ocs.data` directly.
+ * Throws {@link ApiError} on HTTP errors or non-success OCS status codes.
+ */
+export async function fetchFormsAPI(endpoint, options = {}) {
+    const config = getNextcloudConfig();
+    const auth = Buffer.from(`${config.user}:${config.password}`).toString('base64');
+    let url = `${config.url}/ocs/v2.php/apps/forms/api/v3${endpoint}`;
+    if (options.queryParams) {
+        const params = new URLSearchParams(options.queryParams);
+        url += `?${params.toString()}`;
+    }
+    const headers = {
+        Authorization: `Basic ${auth}`,
+        'OCS-APIRequest': 'true',
+        Accept: 'application/json',
+    };
+    let body;
+    if (options.body !== undefined) {
+        body = JSON.stringify(options.body);
+        headers['Content-Type'] = 'application/json';
+    }
+    const method = options.method ?? 'GET';
+    const t0 = Date.now();
+    const response = await fetch(url, { method, headers, body });
+    logger.trace({ method, url, status: response.status, ms: Date.now() - t0 }, '[forms] HTTP');
+    if (!response.ok) {
+        const text = await response.text();
+        throw new ApiError(response.status, response.statusText, text);
+    }
+    if (response.status === 204) {
+        return undefined;
+    }
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!contentType.includes('application/json')) {
+        return undefined;
+    }
+    const json = (await response.json());
+    const code = json?.ocs?.meta?.statuscode;
+    if (code !== undefined && code !== 200 && code !== 100) {
+        throw new ApiError(code, json.ocs.meta.status ?? 'error', json.ocs.meta.message ?? '');
+    }
+    return json.ocs.data;
+}

package/dist/client/polls.js

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: MIT
+import { getNextcloudConfig } from '../tools/types.js';
+import { logger } from '../logger.js';
+import { ApiError } from './aiquila.js';
+/**
+ * Make an authenticated request to the Nextcloud Polls REST API v1.0.
+ *
+ * Base path: /index.php/apps/polls/api/v1.0
+ */
+export async function fetchPollsAPI(endpoint, options = {}) {
+    const config = getNextcloudConfig();
+    const auth = Buffer.from(`${config.user}:${config.password}`).toString('base64');
+    let url = `${config.url}/index.php/apps/polls/api/v1.0${endpoint}`;
+    if (options.queryParams) {
+        const params = new URLSearchParams(options.queryParams);
+        url += `?${params.toString()}`;
+    }
+    const headers = {
+        Authorization: `Basic ${auth}`,
+        'OCS-APIRequest': 'true',
+        Accept: 'application/json',
+    };
+    let body;
+    if (options.body !== undefined) {
+        body = JSON.stringify(options.body);
+        headers['Content-Type'] = 'application/json';
+    }
+    const method = options.method ?? 'GET';
+    const t0 = Date.now();
+    const response = await fetch(url, { method, headers, body });
+    logger.trace({ method, url, status: response.status, ms: Date.now() - t0 }, '[polls] HTTP');
+    if (!response.ok) {
+        const text = await response.text();
+        throw new ApiError(response.status, response.statusText, text);
+    }
+    if (response.status === 204) {
+        return undefined;
+    }
+    const contentType = response.headers.get('content-type') ?? '';
+    if (contentType.includes('application/json')) {
+        return (await response.json());
+    }
+    return undefined;
+}

package/dist/tool-registry.js

@@ -34,6 +34,8 @@ import { notificationsTools } from './tools/apps/notifications.js';
 import { trashTools } from './tools/apps/trash.js';
 import { versionsTools } from './tools/apps/versions.js';
 import { projectsTools } from './tools/apps/projects.js';
+import { pollsTools } from './tools/apps/polls.js';
+import { formsTools } from './tools/apps/forms.js';
 /**
  * Single source of truth for tool-to-Nextcloud-app mapping.
  *
@@ -72,6 +74,8 @@ export const TOOL_REGISTRY = [
     { category: 'talk', appIds: ['spreed'], tools: talkTools },
     { category: 'circles', appIds: ['circles'], tools: circlesTools },
     { category: 'bookmarks', appIds: ['bookmarks'], tools: bookmarksTools },
+    { category: 'polls', appIds: ['polls'], tools: pollsTools },
+    { category: 'forms', appIds: ['forms'], tools: formsTools },
     { category: 'assistant', appIds: ['assistant'], tools: assistantTools },
     { category: 'translate', appIds: ['text_translate', 'translate'], tools: translateTools },
     { category: 'user_status', appIds: ['user_status'], tools: userStatusTools },