English Français العربية

AIquila — Nextcloud MCP Server

السجل الرسمي الإنتاجية

Nextcloud MCP server — 345 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notes

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http aiquila-nextcloud-mcp-server 'https://{hostname}/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "aiquila-nextcloud-mcp-server": {
            "type": "http",
            "url": "https://{hostname}/mcp"
        }
    }
}
NPM package aiquila-mcp
Claude Code 
claude mcp add aiquila-nextcloud-mcp-server -e 'NEXTCLOUD_URL=<NEXTCLOUD_URL>' -e 'NEXTCLOUD_USER=<NEXTCLOUD_USER>' -e 'NEXTCLOUD_PASSWORD=<your nextcloud_password>' -- npx -y aiquila-mcp@0.4.19
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "aiquila-nextcloud-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "aiquila-mcp@0.4.19"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<your nextcloud_password>"
            }
        }
    }
}

متغيرات البيئة

  • NEXTCLOUD_URL إلزامي URL of your Nextcloud instance (e.g. https://cloud.example.com)
  • NEXTCLOUD_USER إلزامي Nextcloud username
  • NEXTCLOUD_PASSWORD إلزامي سري Nextcloud app password (generate in Nextcloud Security settings)
OCI package ghcr.io/elgorro/aiquila-mcp:0.4.19
Claude Code 
claude mcp add aiquila-nextcloud-mcp-server -e 'NEXTCLOUD_URL=<NEXTCLOUD_URL>' -e 'NEXTCLOUD_USER=<NEXTCLOUD_USER>' -e 'NEXTCLOUD_PASSWORD=<your nextcloud_password>' -- docker run -i --rm ghcr.io/elgorro/aiquila-mcp:0.4.19
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "aiquila-nextcloud-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/elgorro/aiquila-mcp:0.4.19"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<your nextcloud_password>"
            }
        }
    }
}

متغيرات البيئة

  • NEXTCLOUD_URL إلزامي URL of your Nextcloud instance (e.g. https://cloud.example.com)
  • NEXTCLOUD_USER إلزامي Nextcloud username
  • NEXTCLOUD_PASSWORD إلزامي سري Nextcloud app password (generate in Nextcloud Security settings)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AIquila
  2. What is AIquila?
  3. How it works
  4. Getting Started
  5. Contributing
  6. Support
  7. License

AIquila

Private AI for your Nextcloud — your data, your server, your choice of AI provider

What is AIquila?

AIquila brings AI to your self-hosted Nextcloud. Instead of keeping your files, notes, tasks and recipes locked inside Nextcloud — or copying them by hand into a chat window — AIquila lets an AI assistant read and write your Nextcloud data directly. Your data stays on your own server, and you decide which AI provider sees it: a hosted API, or a model running on your own hardware that sends nothing to anyone.

How it works

AIquila has three components that can be used independently or together:

MCP Server — A Model Context Protocol server that gives any MCP-compatible AI assistant secure access to your Nextcloud. 342 tools across 44 categories: browse and manage files, keep calendars, tasks and contacts in sync, work in Talk, Deck and Mail, organise photos, notes and bookmarks, and run Coworkers and occ administration. It has no model of its own — it exposes Nextcloud to whichever MCP client you connect.

Nextcloud App — A native Nextcloud application that brings AI directly into the Nextcloud UI. Chat about your documents, summarise and rewrite text, run Coworkers (saved, repeatable AI jobs), and scope a conversation to a Project so the assistant only sees the folders you choose. Admins pick which providers are available, and may restrict them per user or group.

Hetzner Deployment — A single-command provisioning tool (aiquila-hetzner) that stands up a production-ready AIquila server on Hetzner Cloud, complete with Traefik reverse proxy, CrowdSec intrusion prevention, TLS, and optional monitoring.

AI providers

The Nextcloud app supports five providers for chat. Each user can pick a provider and model per conversation, within what the admin allows.

ProviderHostingNotes
Claude (Anthropic)Anthropic APIThe default, and the most deeply integrated: vision, thinking budgets, native MCP connector, and PDF handling with citations.
Hetzner InferenceHetzner (German provider)OpenAI-compatible. Currently an experimental Hetzner service, free while experimental; Hetzner states it does not store request and response content. Tokens from experiments.hetzner.com.
MistralMistral API (French provider)Also supports the native MCP connector. Mistral offers EU-only processing through its regional inference endpoints.
Local modelYour own hardwareOllama, LM Studio or llama.cpp. Nothing leaves your infrastructure. Supports bearer/basic/header auth and mTLS.
DeepSeekDeepSeek APIOpenAI-compatible. No native MCP connector.

Provider choice applies to chat, the per-conversation model picker and the Nextcloud Assistant / TaskProcessing integrations, which all run on the provider the user has selected. Assistant actions that send images ("Analyze images", "Extract text from image") need a vision-capable provider, and report which of the available ones qualify when the selected provider is not.

Getting Started

Pick the path that fits your setup:

PathWhat you getGuide
npx aiquila-mcpLocal MCP client + NextcloudQuick start
Docker + OAuthRemote MCP client + NextcloudQuick start
Nextcloud AppAI inside the Nextcloud UIQuick start
Hetzner CloudFull production deployQuick start
Mobile + VoicePhone + Nextcloud hands-freeQuick start

Contributing

Contributions are welcome. Please read CONTRIBUTING.md first — most importantly, open or comment on an issue before writing code, so we can confirm the approach before you invest the effort.

The guide covers branch and commit conventions, the checks CI runs per component, and what to expect from CI on a pull request from a fork.

Support

AIquila is free software and developed in the open. If it is useful to you, funding covers the running costs behind it — test servers, CI minutes, domains and the App Store presence:

Contributing time — issues, pull requests, documentation, or simply telling other people about the project — helps just as much.

License

AGPL-3.0 (Nextcloud App) / MIT (MCP Server)

See ACKNOWLEDGMENTS.md for the open-source projects and services AIquila is built on.

الأسئلة الشائعة

ما هو AIquila — Nextcloud MCP Server؟

Nextcloud MCP server — 345 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notes

كيف أثبّت AIquila — Nextcloud MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http aiquila-nextcloud-mcp-server 'https://{hostname}/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AIquila — Nextcloud MCP Server إلى مفتاح API؟

نعم. يتطلب NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_PASSWORD، وتضبطها في إعداداته.

هل AIquila — Nextcloud MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AIquila — Nextcloud MCP Server؟

ينشره elgorro. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.